Markdown 转 HTML 到底在做什么
Markdown 转 HTML 做的事情很具体：把人写起来轻量的标记格式，解析成浏览器真正渲染的尖括号标签。内容没变，变的只是它的写法——`#` 开头变成 `h1`、`h2`，`-` 开头变成 `ul` 里的 `li`，两个星号变成 `em`，三个反引号包起来的块变成 `pre` 里的 `code`。其它的段落、链接、图片，都遵循同样一对一的映射规则。
为什么这一步是流程里的关键环节，而不是一次性按钮
作者用 Markdown 写，是因为源文件清爽好读；CMS、邮件客户端、RSS 阅读器、静态站构建器消费的是 HTML，因为渲染层只懂这一种。转换正好卡在这两端中间——一边维护 Markdown 源稿、一边维护 HTML 产物，把这座桥做对，两边都顺。
不同 Markdown 渲染器真正会分歧的地方
标题、列表、强调、链接、围栏代码块——这几样在 CommonMark、GitHub 风格 Markdown、marked、markdown-it 以及各家 CMS 内置解析器里基本一致。真正会分歧的是扩展语法：表格、任务列表、脚注、内嵌 HTML、自动链接。能不能在“本地能预览”和“线上能正确渲染”之间打通，关键就在于知道目标平台到底支持哪一组扩展。
- 表格：CommonMark 本身没有定义，GFM 和大多数 CMS 支持，但列对齐写法在细节上略有差别。
- 任务列表（`[ ]` / `[x]`）：GFM 扩展，并非所有渲染器都会渲染成可勾选控件。
- 内嵌 HTML：有些渲染器原样保留，有些会转义，CMS 端往往还会再跑一遍 sanitizer。
- 裸 URL 自动加链接：GFM 会把 `http://example.com` 自动转链，严格 CommonMark 不会。
- 软换行：大多数引擎会把单个换行压成空格，少数会渲染为 `<br/>`。诗歌、地址、像代码注释那样的段落里要特别留意。
一句话原则：给项目选一种统一的 Markdown 方言并明确写下来。线上事故大多来自“作者用了某个扩展，但目标渲染器静默忽略”。
如何使用这个工具
- 先在 Markdown 转 HTML 中准备一份有代表性的Markdown 标题、列表、链接、强调、代码块和表格类笔记，不要一开始就处理最大或最敏感的真实内容。
- 执行处理流程并生成反映 Markdown 结构的 HTML 标签后，优先检查标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器，再判断结果是否真的可用。
- 只有当结果已经适合用于README 片段、CMS 内容、文档预览、邮件草稿和静态站内容，并且不再触发这条风险提醒时，才复制或下载输出：不同 Markdown 引擎支持的扩展不同，表格、任务列表和内嵌 HTML 应在最终渲染器里确认。
Markdown 转 HTML 示例
这个 Markdown 转 HTML 示例使用有代表性的Markdown 标题、列表、链接、强调、代码块和表格类笔记，展示生成后的反映 Markdown 结构的 HTML 标签，便于你先确认标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器，再把同样设置用于真实输入。
示例输入
## Features - Runs locally - Copies output
预期输出
<h2>Features</h2>
<ul><li>Runs locally</li><li>Copies output</li></ul>一个典型的 Markdown 转 HTML 示例
## 功能
- 本地运行
- 可复制输出
会被转换成
<h2>功能</h2>
<ul><li>本地运行</li><li>可复制输出</li></ul>常见使用场景
Markdown 转 HTML 最适合用在Markdown 标题、列表、链接、强调、代码块和表格类笔记需要快速变成反映 Markdown 结构的 HTML 标签的场景，尤其是README 片段、CMS 内容、文档预览、邮件草稿和静态站内容。
- 用于把 Markdown 文本转换成 HTML 标记，服务于README 片段、CMS 内容、文档预览、邮件草稿和静态站内容。
- 处理重要输入前，可先用示例流程确认标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器。
- 当结果符合目标流程后，再复制或下载反映 Markdown 结构的 HTML 标签。
更稳妥的复核方式
更稳妥的使用方式，是把生成的 HTML 当成一个“可以继续审阅的中间结果”。先看标题层级和列表结构有没有跑偏，再看转义和内嵌 HTML 是否按预期保留，最后才把结果送进 CMS、模板或静态站流程。这样做的好处是，问题会在离你最近的这一层暴露出来，而不是等发布后才发现。
使用注意
- 复用反映 Markdown 结构的 HTML 标签前，先检查标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器。
- 不同 Markdown 引擎支持的扩展不同，表格、任务列表和内嵌 HTML 应在最终渲染器里确认。
- 当结果会影响生产工作或客户可见内容时，应保留原始Markdown 标题、列表、链接、强调、代码块和表格类笔记以便回退和核对。
Markdown 转 HTML 参考说明
Markdown 转 HTML 的参考说明应始终围绕Markdown 标题、列表、链接、强调、代码块和表格类笔记、生成的反映 Markdown 结构的 HTML 标签，以及用于README 片段、CMS 内容、文档预览、邮件草稿和静态站内容前必须确认的检查点。
- 输入重点：Markdown 标题、列表、链接、强调、代码块和表格类笔记。
- 输出重点：反映 Markdown 结构的 HTML 标签。
- 复核重点：标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器。
参考资料
常见问题
以下问题围绕 Markdown 转 HTML 的实际用途整理，重点说明输入要求、输出结果和常见限制。将 Markdown 文本转换为 HTML 标记。
Markdown 转 HTML 最适合处理什么样的Markdown 标题、列表、链接、强调、代码块和表格类笔记？
Markdown 转 HTML 的核心用途是把 Markdown 文本转换成 HTML 标记。当Markdown 标题、列表、链接、强调、代码块和表格类笔记需要快速变成反映 Markdown 结构的 HTML 标签，并继续用于README 片段、CMS 内容、文档预览、邮件草稿和静态站内容时，它最有价值。
复用 Markdown 转 HTML 生成的反映 Markdown 结构的 HTML 标签前，最该检查什么？
应优先检查标题层级、链接、内嵌 HTML、代码围栏、转义和目标系统支持的渲染器。这些细节最能直接判断结果是否已经适合继续交给下游流程。
Markdown 转 HTML 生成的反映 Markdown 结构的 HTML 标签通常会被带到哪里继续使用？
最常见的下一步就是用于README 片段、CMS 内容、文档预览、邮件草稿和静态站内容。这类输出是按真实交接场景来组织的，不是泛化占位结果。
什么时候不应该直接相信 Markdown 转 HTML 的结果，而要人工复核？
不同 Markdown 引擎支持的扩展不同，表格、任务列表和内嵌 HTML 应在最终渲染器里确认。