Markdown to HTML Converter

What problem it solves

When Markdown needs to become a web page, plain conversion often lacks code highlighting, theme adaptation, and mobile reading comfort. markdown-2-html does not only wrap tags; it turns example.md into a standalone example.html that makes technical notes, API docs, and code samples readable directly in a browser.

How it works

The skill organizes conversion around single-file HTML output. Its core script accepts a Markdown input path, with optional output path and page title:
- It parses common Markdown syntax such as headings, lists, links, images, blockquotes, and tables.
- It generates syntax-highlighted styles for bash, python, javascript, json, html, and css code blocks.
- It injects light and dark mode styles so the page follows the system theme.
- It uses a professional monospace font stack, language labels, and horizontal scrolling to improve code readability.
- It constrains desktop width and adapts mobile margins for clearer Chinese typography.

Boundaries

It fits lightweight publishing, sharing, or quick layout validation of static Markdown documents. The generated HTML is a self-contained single file, while image links still depend on original URLs or relative paths. Missing language markers on code blocks may limit highlighting.