什么是 Markdown 以及如何使用它?
Markdown 是一种轻量级标记语言,允许你使用纯文本编辑器创建格式化的文本。Markdown 最初由 John Gruber 于 2004 年创建,广泛用于文档编写、博客、笔记,甚至网站和应用程序中的内容格式化。
在本文中,我们将介绍什么是 Markdown,它的常见用途,以及如何应用其最重要的格式化功能。
什么是 Markdown?
Markdown 是一种在 Web 上样式化文本的简单方法。Markdown 允许用户使用可读的纯文本语法进行编写,然后将其转换为 HTML,而无需使用复杂的 HTML 标签或所见即所得编辑器。
例如,要使文本加粗,你只需将其用双星号 **这样**
包裹起来;要创建列表,你可以使用短划线或数字。
Markdown 因其简单性和灵活性的平衡而受欢迎,这使得技术和非技术用户都可以轻松使用。
Markdown 的常见用例
Markdown 用于许多需要样式化或结构化纯文本的地方。
技术文档
开发人员和技术作家经常使用 Markdown 来编写文档,因为它具有可读性,并且易于与 Git 等版本控制系统集成。
GitHub 中的 README 文件
GitHub 本机支持 Markdown 用于 README 文件和文档。它是介绍和解释项目的默认格式。
博客和内容写作
许多现代静态站点生成器(如 Jekyll、Hugo 和 Next.js)都支持 Markdown 进行内容创建。诸如 Ghost 和 Dev.to 之类的博客平台也使用它。
笔记应用
诸如 Obsidian、Notion(部分支持)和 Bear 之类的应用程序允许用户使用 Markdown 语法编写笔记,以便于格式化。
电子邮件格式和消息传递
某些电子邮件客户端和消息传递平台(如 Slack 和 Discord)允许使用部分 Markdown 语法进行基本格式化,例如粗体、斜体或代码块。
基本 Markdown 语法以及如何使用它
Markdown 语法简单明了且易于阅读。以下是你需要的最常见元素。
标题
使用 #
符号创建标题。#
符号的数量对应于标题级别。
# H1 - 主标题
## H2 - 章节标题
### H3 - 小节标题
强调
你可以用斜体或粗体强调文本:
*斜体文本* or _斜体文本_
**粗体文本** or __粗体文本__
***粗体和斜体*** or ___粗体和斜体___
列表
Markdown 同时支持无序列表和有序列表。
-
无序列表:
- 项目 1 - 项目 2 - 子项目
-
有序列表:
1. 第一项 2. 第二项 1. 嵌套项
链接
要添加超链接,请使用方括号表示文本,并使用圆括号表示 URL:
[访问 OpenAI](https://www.openai.com)
图片
图片使用与链接相同的语法,但以感叹号开头:

块引用
要创建块引用,请在行首添加 >
:
> 这是一个块引用。
代码和代码块
对于内联代码,请用反引号将文本括起来:
使用 `console.log()` 函数。
对于多行代码块,请使用三个反引号:
```javascript function greet(name) { return `Hello, ${name}`; } ```
水平线
使用三个或更多个破折号、星号或下划线来创建水平线:
---
表格
Markdown 表格使用竖线和连字符:
| 语法 | 描述 |
|--------|-------------|
| 标题 | 标题 |
| 单元格 | 内容 |
Markdown 写作技巧
- 使用 Markdown 预览工具(例如 VS Code、Typora 或 StackEdit)即时查看输出。
- 撰写较长的文档时,请使用适当的标题来组织各个部分。
- 使用一致的格式以保持清晰。
- 使用注释(HTML 样式
<!-- Comment -->
)留下不会出现在最终输出中的注释。