What happens to semantic HTML5 tags like and ?

These are treated as transparent block wrappers, ensuring the content flows normally while maintaining its semantic relationship.

Can I customize the heading styles in the conversion?

Yes, the skill supports multiple implementation options including ATX (hashes), Setext (underlined), and ATX Closed styles.

Is there support for Japanese Ruby annotations?

Yes, the skill includes logic to extract base text and rt annotations into a readable Markdown format.

How are complex HTML elements like tables handled?

The mapping rules convert HTML tables into Markdown pipes and dashes, preserving headers, alignment, and internal cell formatting.

Does this skill support GitHub Flavored Markdown (GFM)?

Yes, it specifically includes mapping rules for GFM-compliant tables and double-tilde strikethrough syntax.

Markdown Mapping & Conversion Rules

Name: Markdown Mapping & Conversion Rules
Author: kreuzberg-dev

bykreuzberg-dev

•

480

•

Content Management

Maps over 60 HTML element types to semantic Markdown equivalents using high-performance, CommonMark-compliant logic.

This skill provides a comprehensive reference and implementation logic for mapping complex HTML structures into clean, semantic Markdown. It enables the conversion of standard elements like headings and lists alongside advanced structures such as GFM-compliant tables, definition lists, and semantic HTML5 elements. Designed for the high-performance html-to-markdown converter, it ensures that document transformations remain accurate and structurally sound for use in documentation, static sites, and LLM training data.

Key Features

01Handles complex structures like GFM tables and definition lists

02Maps 60+ HTML elements to semantic Markdown

03Maintains semantic accuracy for HTML5 elements like <article> and <section>

04480 GitHub stars

05Supports multiple heading styles including ATX, Setext, and ATX Closed

06Configurable code block styles including Backticks, Tildes, and Indentation

Use Cases

01Converting legacy web documentation into modern Markdown repositories

02Standardizing content across different publishing platforms and static site generators

03Pre-processing web-scraped data into structured Markdown for AI model consumption

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kreuzberg-dev/html-to-markdown conversion-mapping-rules

For use in Claude.ai and ChatGPT

Download Skill