Markdown 入门:五分钟上手

Markdown 是一种用纯文本写格式的语言。五分钟能学会,学会之后你写笔记、写文档、写公众号草稿都会换用它。

核心就一句:用几个符号表示格式,内容还是纯文本。 所以它能在任何地方打开,二十年后还能读。

一、最常用的八个语法

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

**加粗**  *斜体*  ~~删除线~~

- 无序列表
- 第二项
  - 缩进两个空格变成子项

1. 有序列表
2. 第二项

> 引用,用来放重点或别人的话

`行内代码`

```python
# 代码块,三个反引号包起来
print("hello")
```

[链接文字](https://example.com)

![图片说明](图片地址)

就这些。剩下的都是扩展语法,用到再查。

二、表格

| 姓名 | 部门 | 工号 |
|------|------|------|
| 张三 | 设计 | 001 |
| 李四 | 开发 | 002 |

第二行的 --- 是分隔线,必须有。想要对齐就在两边加冒号::--- 左对齐、---: 右对齐、:---: 居中。

三、写文档的四个实用技巧

1. 标题层级别跳

从 # 到 ### 逐级往下,别从一级直接跳到三级。跳级会让目录结构乱,导出 PDF 或网页时排版会出问题。

2. 一行只做一件事

Markdown 里换行不生效,要空一行才分段。所以别在一行里塞三句话,读起来累。

3. 用列表代替长段落

超过四行的段落,考虑拆成列表。纯文本没有加粗和颜色,靠结构传递信息。

4. 图片用相对路径

写 ![截图](./images/a.png) 而不是绝对路径。这样整个文件夹搬到哪都能用。

四、用什么工具写

工具 适合 说明
Typora 写作 所见即所得,付费但值得
Obsidian 知识库 本地文件、双链、插件多
VS Code 技术文档 免费,预览方便,适合写代码相关
Notion 协作 本质是块编辑器,但支持 Markdown 语法
语雀 / 飞书文档 团队 中文友好,支持导入导出

五、导出时注意什么

Markdown 只是中间格式,最终要导出成 PDF、Word 或网页:

  • 导出 PDF:先在编辑器里预览,表格太宽会溢出。长表格改用列表或拆表。
  • 导出 Word:用 Pandoc,配合模板文件可以保留样式。
  • 发布网页:大多数静态站生成器(Hugo、Hexo、Astro)原生支持 Markdown。

常见问题

Q:换行为什么不生效?
A:Markdown 把单个换行当空格。要分段就空一行,要强制换行就在行尾加两个空格。

Q:星号会被当成格式怎么办?
A:前面加反斜杠转义,\* 就显示成星号。

Q:不同工具渲染结果不一样?
A:正常。Markdown 有多个方言(CommonMark、GFM 等)。写通用文档时只用基础语法,别用太偏的扩展。

Q:值得专门学吗?
A:值得。投入五分钟,之后所有写作场景都能用,而且永远不怕软件倒闭导致文档打不开。