1. 前言

Markdown 的源以 md 为后缀。Markdown 是 HTML 语法的简化版本，它本身不带有任何样式信息。我们所看到的 Markdown 网页（如：github 里常用的 README.md ）、Markdown 编辑器（比如 Typora）预览的，其实都是将 Markdown 文档首先转换成 HTML ，再配以某些认预定共同渲染而成的。

例如，同样的一段表格，在 Typora 和 VS Code 预览中的表现不同：

为了让 Markdown 的表现形式稳定，我们可将 Markdown 导出成 HTML 。

2. 语法详解

Typora 导出 HTML 的操作方式为：

「」->「导出」->「HTML」

注意：导出时可以看到 HTML 和 HTML（Without Styles）两个选项，它们的区别是：

导出 HTML 时，会根据 Typora 所选（「栏」->「」），导出扩展在内的所有；

导出 HTML（Without Styles）时，的 HTML 只包含 Markdown 基本语法的转换，不含任何扩展及样式。

例如，同样的一段表格，导出 HTML 和 HTML（Without Styles）的不同表现：

一般情况下，推荐使用「导出 HTML」的。
除非需要重新定义样式及扩展，否则不推荐使用「导出 HTML（Without Styles）」的导出方式。

如果只有 Markdown 源，在不通过 Markdown 编辑器的情况下，还可以使用 Pandoc 将其直接转换成 HTML 。

Pandoc 是一种语言转换工具，可实现不同语言格式转换。

Pandoc 的安装参见其 。

实例 1：

使用 Pandoc 将 Markdown 转换为 Html。

pandoc in.md -o out.html

实例 2：

转换时外部样式引用，如：style.css。

pandoc in.md -c style.css out.html

注意：此时的是目录。

实例 3：

将所有外部都嵌入到单个 HTML 中，嵌入视频、等。

pandoc -s --self-contained -c style.css in.md -o out.html

Markdown 有一些扩展语法，比如「Mermaid」，「数学公式」等，要此类，Pandoc 也需要一些的，例如： 可用于渲染 Mermaid 图像。

3. 小结

Markdown 源只规定了的，并没有定义的样式，所以在不同的预览环境下会看到不同的。为了使其保持统一，需要将 Markdown 成 HTML ；

常见的 Markdown 编辑器都带有导出成 HTML 的，导出后通常含有编辑器样式；

利用 Pandoc，我们可以在命令行中直接将 Markdown 导出成 HTML 。