第 5 课
预览与 HTML 导出
理解实时预览、净化 HTML 片段,以及何时复制 Markdown 或 HTML。
Markdown 工具通常提供两种不同输出:
- 渲染预览:写作时阅读用
- HTML 导出:给需要 HTML 片段的系统用
两者相关,但不完全相同。
实时预览展示的是什么
实时预览会解析 Markdown,并渲染标题、段落、列表、表格等结构化内容。在浏览器工具里,这通常意味着带 CSS 样式的 HTML 元素。
预览回答的是:「这篇文档读起来是否清楚?」
HTML 导出提供的是什么
HTML 导出会把 Markdown 转成类似这样的标签:
<h1>Title</h1>
<p>Paragraph text.</p>
<ul>
<li>Item</li>
</ul>
好的工具会对 HTML 做净化,避免 Markdown 中的原始 HTML 块变成可执行内容。
HTML 导出回答的是:「我可以粘贴到其他系统里的片段是什么?」
何时复制 Markdown,何时复制 HTML
| 目标 | 更合适的选择 |
|---|---|
| GitHub README 或 Issue | Markdown 源文 |
使用 .md 的文档仓库 | Markdown 源文 |
| CMS 富文本字段 | HTML 片段 |
| 邮件或内网 Wiki | HTML 片段(通常仍需人工检查) |
| 代码评审讨论 | Markdown 源文 |
大多数发布流水线更偏好 Markdown,因为最终站点会应用自己的主题样式。
预览主题与导出的关系
预览样式能让写作更舒适,但复制出来的 HTML 通常不会带上预览主题 CSS,除非工具明确导出「带样式 HTML」。这是正常现象。
关键结论
用预览验证结构与可读性;当下游系统需要语义 HTML 而不是 Markdown 源文时,再使用 HTML 导出。
Markdown 预览 / Markdown 转 HTML 工具 同时支持两条路径:实时预览,以及复制/下载净化后的 HTML 片段。