不会排版也能写出漂亮文档：Markdown 入门，10 分钟掌握常用语法

你可能在 GitHub、技术博客、知识管理软件中见过 .md 文件。它们通常就是使用 Markdown 编写的。好消息是，Markdown 不需要复杂的编程知识，普通用户也能轻松上手。

一、Markdown 是什么？

Markdown 的核心思想是：使用简单的文本符号表达内容结构，再由支持 Markdown 的编辑器将其转换成整齐的页面。

例如，想让一行文字成为一级标题，只需要在前面添加一个 #：

# 我的学习笔记

这是今天学习的第一篇笔记。

渲染后，第一行会显示为醒目的大标题，第二行则是普通正文。

Markdown 文件通常使用 .md 作为扩展名，可以用普通文本编辑器编写，也可以使用支持实时预览的 Markdown 编辑器。

二、掌握 6 个最常用的语法

1. 标题：使用井号

Markdown 支持六级标题，井号数量代表标题层级。

# 一级标题
## 二级标题
### 三级标题

建议按照文章结构合理安排层级，不要仅仅为了让文字变大而随意选择标题级别。

2. 加粗和斜体：突出重点

**这是一段加粗文字**

*这是一段斜体文字*

加粗适合突出关键词，斜体适合表示补充说明。不要给每句话都添加格式，否则重点反而不明显。

3. 列表：整理要点

无序列表使用 -：

- 学习 Python
- 整理笔记
- 每周复习

有序列表使用数字和句点：

1. 打开软件
2. 创建文件
3. 保存内容

如果要写操作教程，有序列表尤其方便。

4. 链接：快速引用网页

使用下面的格式：

[访问 OpenAI 官网](https://openai.com/)

显示时，文字会变成可点击链接。

这种写法很适合整理参考资料、教程地址和常用网站。

5. 代码：避免命令和程序混在正文里

如果只是展示一小段命令，可以使用反引号：

运行 `python --version` 查看版本。

如果需要展示多行代码，则使用三个反引号包围：

```python
print("Hello, Markdown!")
```

也可以在开头标注语言名称，例如 python、javascript 或 bash，让支持语法高亮的编辑器更容易识别代码类型。

6. 引用：标记补充说明

在文字前面添加 >：

> 每天进步一点点，也是一种成长。

引用格式适合突出提醒、摘录或重要观点。

三、动手练习：制作一份完整的学习笔记

现在，我们把上面的语法组合起来，创建一份真正可以使用的 Markdown 文档。

新建文件 study.md，输入以下内容：

# 我的 Python 学习笔记

## 今天的目标

掌握 Python 的基础输出功能。

## 学习内容

1. 了解 print() 函数
2. 学会输出文字
3. 尝试运行第一个程序

## 示例代码

```python
name = "小明"
print("你好，" + name)
```

## 学习总结

- 已经掌握基本输出
- 需要继续练习变量
- 明天学习数据类型

> 坚持练习比一次学很多更重要。

保存文件后，使用支持 Markdown 的编辑器打开预览。

你会发现，原本由符号组成的纯文本已经变成了有标题、有列表、有代码区块的完整笔记。

四、哪些工具可以用来写 Markdown？

Markdown 不依赖某个特定软件，选择工具时可以根据自己的使用习惯决定。

• Visual Studio Code： 适合写代码和技术文档，可以通过快捷键打开 Markdown 预览。
• Obsidian： 适合整理个人知识库、学习笔记和长期资料。
• Typora： 提供所见即所得的 Markdown 编辑体验。
• 普通文本编辑器： 只要能保存纯文本，就可以编写 Markdown，甚至不需要安装专门软件。

如果你刚开始学习，建议先用自己电脑已有的文本编辑器练习语法，再根据需要选择其他工具。

五、初学者容易遇到的几个问题

1. 为什么输入井号后没有变成标题？

Markdown 需要经过支持它的渲染器才能显示格式。普通文本编辑器只会显示原始符号，这是正常现象。

2. 为什么列表没有正确显示？

检查列表标记后面是否有空格，并注意不同 Markdown 解析器可能存在细节差异。

3. 为什么代码没有高亮？

确认代码块使用了成对的三个反引号，并在开头正确标注语言名称。

4. Markdown 能不能转换成 PDF 或 Word？

可以。许多 Markdown 编辑器提供导出功能，也可以使用专门的文档转换工具。不过，不同工具的排版效果可能略有差异，导出后最好检查一次。

六、养成一个好习惯：内容和格式分开管理

Markdown 最大的优势之一，是它本质上属于纯文本格式。你可以轻松搜索、复制、比较和迁移内容，不必依赖某个特定软件才能读取原始文字。

建议给笔记建立简单的目录，例如：

我的笔记/
├── 编程/
│   ├── Python.md
│   └── JavaScript.md
├── 效率工具/
│   └── Markdown.md
└── 每日记录/
    └── 2026-10-31.md

这样，学习资料就能逐渐形成自己的知识库。

总结： Markdown 不需要复杂的操作，只要掌握标题、列表、加粗、链接、代码和引用这六种基本语法，就能高效编写整洁的笔记、博客和技术文档；从今天开始，把下一篇学习笔记保存为 .md 文件吧。