对比
HTML 与 Markdown
HTML 描述结构化网页内容，可细致控制元素；Markdown 提供简洁的编写语法，通常会转换为 HTML。选择取决于内容编辑者和发布方式。
应该选择哪种格式？
平台能可靠渲染时，用 Markdown 编写简单易读的内容；需要精确控制结构、语义或布局时用 HTML。
适用于 HTML
创建网页结构和内容
- 语义化标题、段落和链接
适用于 Markdown
技术文档和 README 文件
- 含标题、链接和代码的轻量文档
基本信息
| 项目 | HTML | Markdown |
|---|---|---|
| 扩展名 | .html, .htm | .md, .markdown |
| MIME 类型 | text/html | text/markdown |
| 常见用途 | 创建网页结构和内容 | 技术文档和 README 文件 |
| 打开方式 | 用浏览器或文本编辑器打开。发布前在目标浏览器中检查显示效果。 | 使用文本编辑器、Markdown 编辑器或仓库预览打开。发布前检查目标服务采用的方言和已启用扩展。 |
| 导出或转换 | 可按需要导出为PDF，但链接和动态功能不一定能以相同方式保留。 | 使用合适工具导出 HTML 或 PDF。先检查方言、图像和链接相对路径、代码块及表格支持。 |
按用途选择
语义化标题、段落和链接
创建网页结构和内容
HTML含标题、链接和代码的轻量文档
技术文档和 README 文件
Markdown关键点 1
Markdown 编写简洁，通常需要渲染器才能显示。
进一步了解差异关键点 2
HTML 可直接表达网页元素并提供更细致的语义。
进一步了解差异进一步了解差异
确认目标平台支持的语法和渲染规则。预览标题、链接、表格、图片及嵌入内容；必要时对不可信 HTML 进行净化。
- Markdown 源码旨在保持纯文本可读性。
- HTML 通过明确的元素和属性描述网页文档。
- Markdown 通常是发布流程中的源格式，而非渲染后 HTML 的替代品。
常见问题
Markdown 会取代网页中的 HTML 吗？
通常不会；许多系统会先将 Markdown 转换为 HTML，且扩展支持各不相同。