Markdown
Markdown (.md) 文件格式完整指南
什么是 .MD 文件？
Markdown 是一种轻量级标记语言，使用纯文本格式编写，通过简单的符号和语法规则来定义文档结构与样式。扩展名为 .md 或 .markdown 的文件即为 Markdown 格式文档。它的设计理念是让人们"以易于阅读、易于编写的纯文本格式进行写作，并能选择性地将其转换为 HTML"。
Markdown 由 John Gruber 与 Aaron Swartz 于 2004 年共同创建。Gruber 的初衷是设计一种即使不经过渲染、直接阅读原始文本也能轻松理解的格式。这一设计哲学使得 Markdown 迅速在技术写作、博客创作和开发者社区中流行开来。随着时间推移，GitHub、Stack Overflow、Reddit 等主流平台相继采用并扩展了 Markdown 语法，形成了各具特色的变体，例如 GitHub Flavored Markdown（GFM）。2016 年，CommonMark 规范的推出进一步推动了 Markdown 语法的标准化进程。
技术规格
Markdown 本质上是一种纯文本格式，其技术特性与常见的图像或音视频格式有所不同，以下是其主要技术参数：
- 文件扩展名：.md、.markdown、.mdown、.mkd
- MIME 类型：text/markdown（RFC 7763 正式注册）
- 字符编码：通常采用 UTF-8 编码，支持多语言字符集
- 文件结构：纯文本，无二进制数据，可用任意文本编辑器直接读取
- 压缩方式：本身不包含压缩，但纯文本特性使其在 GZIP 等通用压缩下效率极高
- 语法规范：原始 Gruber 语法、CommonMark、GitHub Flavored Markdown（GFM）、MultiMarkdown 等多种变体
- 输出格式：可转换为 HTML、PDF、DOCX、EPUB、LaTeX 等多种格式
- 行尾处理：兼容 Unix（LF）与 Windows（CRLF）换行符
Markdown 的核心语法要素包括：使用 # 标记标题层级、使用 ** 或 __ 表示粗体、使用 * 或 _ 表示斜体、使用反引号标记行内代码，以及使用三个反引号创建代码块。这些符号直观易记，是其广泛普及的重要原因之一。
常见使用场景
Markdown 凭借其简洁性和高兼容性，广泛应用于多个领域：
- 技术文档与 README 文件：几乎所有开源项目都使用 README.md 作为项目说明文档，GitHub 等平台会自动渲染显示
- 博客与内容创作：Hugo、Jekyll、Hexo 等静态网站生成器均以 Markdown 作为主要内容格式
- 知识库与笔记管理：Notion、Obsidian、Typora 等笔记软件采用 Markdown 存储和管理笔记
- 学术写作：结合 Pandoc 工具，Markdown 可用于撰写论文并导出为多种学术格式
- API 文档：Swagger、GitBook 等文档工具均支持 Markdown 格式
- 电子邮件与即时通讯：Slack、Discord、Microsoft Teams 等平台支持 Markdown 语法进行文本格式化
优缺点对比
| 优点 | 缺点 |
|---|---|
| 语法简洁，学习成本极低 | 不同平台的语法存在差异，兼容性问题时有发生 |
| 纯文本存储，文件体积小，版本控制友好 | 复杂排版（如多列布局、精细表格）支持有限 |
| 可转换为 HTML、PDF 等多种格式 | 原生不支持图片尺寸调整、颜色等高级样式 |
| 在任意文本编辑器中均可阅读原始内容 | 数学公式支持依赖扩展，并非所有环境通用 |
| 与 Git 等版本控制系统高度兼容 | 缺乏统一的官方标准，存在多个竞争性规范 |
| 被广大开发者平台和工具原生支持 | 对于非技术用户，初次接触可能不如 Word 直观 |
如何打开和查看 .MD 文件
由于 Markdown 文件本质上是纯文本，几乎所有文本编辑器都能打开它。以下是常用的查看与编辑工具：
- Visual Studio Code：内置 Markdown 预览功能，按 Ctrl+Shift+V 即可实时预览渲染效果，是开发者最常用的选择
- Typora：所见即所得的 Markdown 编辑器，编辑与预览无缝融合，用户体验极佳
- Obsidian：以 Markdown 为核心的知识管理工具，适合构建个人知识库
- Notepad++：Windows 上广受欢迎的文本编辑器，配合插件可实现语法高亮
- GitHub / GitLab：在线平台会自动渲染 Markdown 文件，直接在浏览器中查看格式化内容
- MacDown：macOS 专属的免费 Markdown 编辑器，提供分屏实时预览
- Mark Text：跨平台开源 Markdown 编辑器，支持 Windows、macOS 和 Linux
- 系统自带记事本/文本编辑器：可直接打开原始文本内容，但无法渲染格式
如何在线转换 .MD 文件
在许多工作场景中，我们需要将 Markdown 文件转换为其他格式，以便与不熟悉 Markdown 的同事共享，或用于正式文档输出。常见的转换需求包括将 .md 转为 PDF、HTML 或 DOCX 格式。
对于本地高级转换，Pandoc 是功能最强大的命令行工具，支持数十种格式的互相转换。而对于不希望安装软件的普通用户，在线工具是更便捷的选择。
Metric Converter（metric-converter.com） 提供免费的在线文件转换服务，支持包括 Markdown 在内的多种文档格式转换。只需上传您的 .md 文件，选择目标格式，即可快速完成转换并下载结果，无需注册账号，操作简单高效，适合临时转换需求。
常见问题解答
.md 文件和 .txt 文件有什么区别？
两者都是纯文本文件，本质上没有二进制差异。区别在于 .md 文件遵循 Markdown 语法规范，其中的特定符号（如 #、**、- 等）具有格式化含义，支持 Markdown 的软件会将其渲染为格式化文档。而 .txt 文件则是完全无格式的纯文本，不包含任何特殊语法约定。
为什么同一个 .md 文件在不同平台上显示效果不一样？
这是因为 Markdown 存在多个语法变体（方言），不同平台实现的规范不尽相同。例如，GitHub Flavored Markdown 支持任务列表、表格等扩展语法，而标准 CommonMark 则不一定支持这些特性。此外，各平台使用的 CSS 样式也不同，导致视觉效果存在差异。建议在编写时明确目标平台，优先使用 CommonMark 兼容语法以提高可移植性。
Markdown 文件可以包含图片吗？
可以，但 Markdown 文件本身不内嵌图片数据。它通过语法  引用外部图片。图片文件需要单独存储，可以是本地相对路径或网络 URL。这意味着在分享 .md 文件时，如果使用本地图片路径，还需要一并提供图片文件，否则对方将看不到图片。
如何将 Markdown 转换为 Word 文档（.docx）？
有几种常用方法：第一，使用 Pandoc 命令行工具执行 pandoc input.md -o output.docx，这是最灵活的方式；第二，在 VS Code 中安装相关扩展插件进行导出；第三，使用 Typora 等编辑器的内置导出功能；第四，借助 Metric Converter 等在线转换平台，无需安装任何软件即可完成格式转换，尤其适合偶尔有转换需求的用户。