baoyu-markdown-to-html

baoyu-markdown-to-html - Markdown 转 HTML 转换器

技能概述

将 Markdown 文件转换为带有内联 CSS 样式的精美 HTML，专为微信公众号等平台优化，支持代码高亮、数学公式、图表和多种主题风格。

适用场景

微信公众号文章排版 - 技术博主和开发者可以用 Markdown 写作，一键转换为微信兼容的 HTML 格式，保留代码高亮和样式

技术文档转换发布 - 将项目 README、技术文档、API 文档等 Markdown 内容转换为带样式的 HTML，便于在网站或博客发布

博客文章美化输出 - 为静态博客、个人网站生成美观的 HTML 文章，支持多种主题风格选择

核心功能

Markdown 转 HTML - 完整支持标准 Markdown 语法，包括标题、列表、表格、引用块、图片、链接等，自动转换为内联 CSS 样式的 HTML

代码语法高亮 - 支持多种编程语言的语法高亮显示，转换后代码块在微信公众号等平台仍保持彩色高亮效果

扩展语法支持 - 支持 Mermaid 流程图、PlantUML 图表、数学公式、脚注、警告块（Alerts）、注音（Ruby）等 Markdown 扩展语法

常见问题

转换后的 HTML 可以直接粘贴到微信公众号编辑器吗？

是的，转换后的 HTML 使用内联 CSS 样式，可以直接复制粘贴到微信公众号编辑器、知乎、掘金等平台，样式会被保留。建议使用"默认主题"以获得最佳兼容性。

支持哪些 Markdown 扩展功能？

支持 Mermaid 流程图、PlantUML 图表、数学公式（KaTeX/LaTeX）、脚注引用、警告块（[!NOTE]/[!WARNING] 等）、注音标注等。注意图表需要依赖外部渲染服务，在部分平台可能需要额外配置。

如何自定义 CSS 样式？

可以通过创建 EXTEND.md 配置文件来覆盖 CSS 变量、设置默认主题、自定义代码块样式等。配置文件支持项目级和用户级，优先级：项目配置 > 用户配置 > 默认设置。