Markdown 是一种轻量级文本格式化语法，可将纯文本转换为结构化文档。它由 John Gruber 创建于 2004 年，现在已成为文档、自述文件、博客文章和开发人员交流的标准格式。本指南解释了 Markdown 是什么、人们使用它的原因以及如何开始。
什么是 Markdown？
Markdown 是一种使用简单标点符号向纯文本添加格式的方法。您在文本编辑器中编写，Markdown 由处理器呈现为格式化输出（HTML、PDF 等）。
例如：
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item two呈现为：
这是一个标题
这是一个 粗体字 这是 italic.
- 列出项目一
- 清单第二项
格式存在于文本本身中 — 没有隐藏的 XML、没有二进制格式、没有专有编码。
为什么创建 Markdown？
在 Markdown 之前，网络编写者面临着一个选择：用原始 HTML 编写（乏味且容易出错）或使用生成混乱代码的所见即所得编辑器。John Gruber 将 Markdown 设计为：
- 按原样可读 ——即使没有渲染，
**bold**读起来很清楚是强调 - 任何人都可写 — 没有特殊软件，只是一个文本编辑器
- 可转换为 HTML — 主要输出格式
原始规范侧重于生成干净的 HTML。但 Markdown 此后已传播到数十种平台和输出格式。
Markdown 在哪里使用？
Markdown 在技术中无处不在：
| 平台 | Markdown 的作用 |
|---|---|
| GitHub | 自述文件、问题、拉取请求、wiki |
| Notion | 页面内容和文档 |
| Obsidian | 保险库中的所有笔记 |
| WordPress | 通过 Markdown 插件发布 |
| GitBook | 文档页面 |
| 松弛/不和谐 | 消息格式 |
| 堆栈溢出 | 问题与解答 |
| 杰基尔/雨果/阿斯特罗 | 博客文章和静态页面 |
| Jupyter 笔记本 | 文档单元 |
如果您编写任何技术内容，您几乎肯定遇到过 Markdown。
Markdown 与 Word：主要区别
| 方面 | Word | Markdown |
|---|---|---|
| 格式 | 二进制 (.docx) | 纯文本 (.md) |
| 便携性 | 需要 Word 或兼容应用程序 | 在任何文本编辑器中打开 |
| 版本控制 | 困难（二进制差异） | 简单（逐行 Git 差异） |
| 渲染 | 内置于应用程序中 | 需要 Markdown 渲染器 |
| 学习曲线 | 所见即所得（无需学习） | 需要学习语法 |
| 平台支持 | 微软生态系统 | 通用开发者工具 |
如果您想要将 Word 文档转换为 Markdown， WordToMD 可以立即处理此问题 - 无需注册，无需上传。
基本 Markdown 语法
以下是最常见的元素：
标题
# Heading 1
## Heading 2
### Heading 3见 Markdown 标题指南 完整参考。
强调
**Bold text**
*Italic text*
~~Strikethrough~~列表
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. Third链接
[Link text](https://example.com)图像
代码
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |块引用
> This is a blockquote.
> It can span multiple lines.Markdown口味
“Markdown”不是单一标准——有多种变体：
- CommonMark — 严格、明确的规范
- GitHub 风格的 Markdown (GFM) — CommonMark + 表格、任务列表、删除线、自动链接
- 多重 Markdown — 添加脚注、引文、元数据
- Pandoc Markdown — 功能最丰富，由 Pandoc 转换器使用
大多数平台至少支持 CommonMark。GitHub、Obsidian 和 GitBook 使用 GFM。如需完整参考，请参阅 Markdown 语法速查表.
如何编写 Markdown
您不需要特殊的软件。选项包括：
- VS 代码 — 免费、强大的编辑器，带有内置 Markdown 预览
- Obsidian — 带图表视图的 Markdown 笔记应用程序
- Typora — 所见即所得 Markdown 编辑器
- iA 作家 — 专注的写作环境
- 任何纯文本编辑器 — 记事本、文本编辑、vim、emacs
Markdown 和其他格式之间的转换
如果您有 Word 文档要转换为 Markdown， WordToMD 只需几秒钟即可完成 — 完全免费，无需上传文件。
相反（Markdown 到 Word 或 PDF），Pandoc 等工具可以处理此转换。参见 Pandoc Word到 Markdown 设置说明。
FAQ
Markdown 是一种编程语言吗？ 不。Markdown 是一种标记语言——它描述格式，而不是逻辑或计算。
我可以在 Microsoft Word 中使用 Markdown 吗？ Word 本身并不呈现 Markdown，但有一些 Word 加载项添加了 Markdown 支持。或者，将 Word 转换为 Markdown WordToMD 并使用 Markdown 编辑器。
Markdown 适合长文档吗？ 是的，具有良好的标题结构。非常长的文档受益于分割成多个文件（如在 GitBook 或 ObsidianVault 中）。
Markdown 使用什么文件扩展名？
.md 是标准。 .markdown 也有效。一些平台使用 .mdx 适用于带有 JSX (React) 组件的 Markdown。
结论
Markdown 是一种简单而强大的格式，已成为技术写作的通用语言。它可以作为纯文本阅读，呈现精美，并且可以与每个主要的开发工具配合使用。如果您是新手，请从 Markdown 语法速查表 并尝试转换您的第一个 Word 文档 WordToMD.