第 5 课

预览与 HTML 导出

理解实时预览、净化 HTML 片段,以及何时复制 Markdown 或 HTML。

Markdown 工具通常提供两种不同输出:

  1. 渲染预览:写作时阅读用
  2. 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 或 IssueMarkdown 源文
使用 .md 的文档仓库Markdown 源文
CMS 富文本字段HTML 片段
邮件或内网 WikiHTML 片段(通常仍需人工检查)
代码评审讨论Markdown 源文

大多数发布流水线更偏好 Markdown,因为最终站点会应用自己的主题样式。

预览主题与导出的关系

预览样式能让写作更舒适,但复制出来的 HTML 通常不会带上预览主题 CSS,除非工具明确导出「带样式 HTML」。这是正常现象。

关键结论

用预览验证结构与可读性;当下游系统需要语义 HTML 而不是 Markdown 源文时,再使用 HTML 导出。

Markdown 预览 / Markdown 转 HTML 工具 同时支持两条路径:实时预览,以及复制/下载净化后的 HTML 片段。

想动手练习时,可使用 DevCove 相关工具——可选,不属于本课正文。

打开相关工具

返回课程概览