Markdown 是互联网的写作格式:README 文件、聊天消息、论坛帖子、技术文档。但网页跑在 HTML 上——每个 CMS、邮件模板和博客文章都需要那次转换。
一分钟对比
Markdown 为打字而设计:**加粗**、# 标题、[链接](url)。纯文本即可读,写起来快。
HTML 为浏览器而设计:<strong>加粗</strong>、<h1>标题</h1>、<a href="url">链接</a>。冗长但绝对——每个属性、类名和样式钩子都在这里。
Markdown 是一个子集:它表达的一切都能映射到 HTML,反之不行。复杂布局、自定义属性、交互元素都是 HTML 专属领地。
转换方法
- 把 Markdown 粘进 Markdown ↔ HTML 转换工具。
- 即时得到干净的 HTML——转换在浏览器本地运行。
- 把 HTML 粘到平台要求的地方。
各格式的胜场
| 场景 | 格式 |
|---|---|
| 写文档、README、聊天、论坛帖子 | Markdown |
| 建网页、邮件、CMS 内容 | HTML |
| 长期的事实来源 | Markdown(可 diff、可迁移) |
| 精细的样式控制 | HTML |
多数团队的标准流程:用 Markdown 写,发布时转成 HTML。 Markdown 文件保留为可编辑源文件,HTML 只是生成的产物。
坑
- Markdown 里的原生 HTML:多数 Markdown 解析器原样放行内嵌 HTML。做一次性自定义元素时很方便——CMS 会清洗 HTML 时又是个陷阱。
- 换行:Markdown 忽略段落内的单个换行。如果转换结果没有在预期处断行,那是规范按设计在工作。
- 表格和嵌套列表:Markdown 最容易翻车的部分——转换结果不对劲时,先简化结构。
用舒服的格式写,用要求的格式发。转换器把这道缝压到两秒宽。