Markdown 与 HTML:什么时候转换

Markdown 与 HTML:什么时候转换

Markdown 是互联网的写作格式:README 文件、聊天消息、论坛帖子、技术文档。但网页跑在 HTML 上——每个 CMS、邮件模板和博客文章都需要那次转换。

一分钟对比

Markdown 为打字而设计:**加粗**、# 标题、[链接](url)。纯文本即可读,写起来快。

HTML 为浏览器而设计:<strong>加粗</strong>、<h1>标题</h1>、<a href="url">链接</a>。冗长但绝对——每个属性、类名和样式钩子都在这里。

Markdown 是一个子集:它表达的一切都能映射到 HTML,反之不行。复杂布局、自定义属性、交互元素都是 HTML 专属领地。

转换方法

  1. 把 Markdown 粘进 Markdown ↔ HTML 转换工具。
  2. 即时得到干净的 HTML——转换在浏览器本地运行。
  3. 把 HTML 粘到平台要求的地方。

各格式的胜场

场景 格式
写文档、README、聊天、论坛帖子 Markdown
建网页、邮件、CMS 内容 HTML
长期的事实来源 Markdown(可 diff、可迁移)
精细的样式控制 HTML

多数团队的标准流程:用 Markdown 写,发布时转成 HTML。 Markdown 文件保留为可编辑源文件,HTML 只是生成的产物。

坑

  • Markdown 里的原生 HTML:多数 Markdown 解析器原样放行内嵌 HTML。做一次性自定义元素时很方便——CMS 会清洗 HTML 时又是个陷阱。
  • 换行:Markdown 忽略段落内的单个换行。如果转换结果没有在预期处断行,那是规范按设计在工作。
  • 表格和嵌套列表:Markdown 最容易翻车的部分——转换结果不对劲时,先简化结构。

用舒服的格式写,用要求的格式发。转换器把这道缝压到两秒宽。