# 你可能本就不需要被Word折磨：10分钟讲明白Markdown，让日常记录像发微信一样简单
这是基础篇的第 1 篇。基础篇致力于用 3~4 篇文章、每篇十分钟的篇幅，让你利用通勤、工作间隙的时间就能够从 0 到 1 搭建一个能写作、能搜索、能切实帮助自己的个人知识库。
针对 Obsidian 的完整语法表可在后台回复markdown查看。
如果要提名一个现代人最觉得破防的生活状态，我觉得一定是「碌碌无为」。
「碌碌无为」的「碌碌」表示你没有在闲着，你可能已经失去了对生活的支配权，沦为工具化的人；而「无为」则表示就算已经这么惨，你得到的好处可能不比彻底躺平多多少。
卷又卷不动，躺又躺不平。这样的后果就是站在卷王和躺平派中间的位置同时被两边嘲笑。每当我想起这一点的时候，我都会在工位上产生强烈的冲动，然后一怒之下……就怒了一下，继续打工。
关于如何打破这样的困境，大家的讨论已经很多了，我也下不了定论。不过可以确定的是：想办法让自己办事更高效一些总是好的。将需要 1 个小时的事情 50 分钟办完，省下的十分钟要么可以让我们更加接近卷王，要么可以省出更多时间躺平。对于如何变高效这个问题，我有一个朴素但管用的办法：记录。
- 1. 把开会的关键信息记下来，就可以免得多次询问同门/同事，减少做错事的概率；你看，效率提高了✅
- 2. 把一天要办的事情记下来，就可以免得忘事之后花更多时间补救，效率提高了✅
- 3. 把工作学习中学到的经验记下来，就可以免得之后要用到重新花时间学习，效率提高了✅
虽然我们生活中到处都是可输入的文本框，但是记录这两个字涵盖了太多迥异的需求。这些需求有的很简单，打一行字发给文件传输助手即可；有些就很麻烦，比如需要 word 排版。我至今都记得写毕业论文那年对着 word 的页眉页脚设置抓耳挠腮的样子。
理想情况下，我们想要这样一个东西：既像发微信一样简单，又能满足一定的排版需求；最好是可以只花打字的工夫就排出 word 模板一样漂亮的版面。
而 markdown 就是为满足这种两难需求而生的。这是用 Obsidian 渲染的 markdown（可以满足多样的排版）：
这也是 markdown（可以满足专业需求）：
在手机上也是完全一样：
本文就争取使用 10 分钟时间，只谈最常用的语法，快速教会你使用 markdown 来记录一切；然后我会根据我自己的经验为你提供几个只有 markdown 能做到的高效率案例，来让你看完马上就能使用；最后，我会用一点点的篇幅解答一些关于它的常见疑惑，并且借此讲述一下 markdown 的设计哲学，以及它应该用来干什么，不该用来干什么。
# 如何使用 markdown
Markdown 不是一个软件，而是一种极度简单的排版方式。实际上，markdown 本质上就是用一些符号标记一段文字，来告诉编辑器你希望这段文字变成什么样。比如两个星号包裹的文字 **加粗文字** 表示这些字需要加粗显示；一个星号包裹的文字 *斜体文字* 表示这些字需要换成斜体。你使用不同的符号，就会有不同的效果。
想清楚了这一点，你就不再需要看那些罗列一堆语法的冗长教程了。我只需要告诉你哪些符号对应哪些效果即可：
- 1. 加粗：
**加粗文字**或__加粗__ - 2. 斜体：
*斜体文字* - 3. 高亮：
==高亮文字==（不是所有编辑器都支持） - 4.
行内代码：`行内代码` - 5. 链接：
[链接名称](网址) - 6. 行内公式 ：
$e=mc^2$（不是所有编辑器都支持） - 7.
删除线：~~删除线~~（不是所有编辑器都支持）
除了一小部分文字，整段文字也是用类似的方法来制作不同的效果。
比如在前面加 # 和一个空格可以让全段文字变大，变成标题格式：
`# 这是标题
# 二级标题
# 三级标题
# 四级标题`
当你在链接 [xx](http://xxx.com) 前加上感叹号 !，编辑器就会试图将链接显示出来。Markdown 中的图片就是这么来的。
Note
在 Obsidian 中，PDF 、MD 等文件的链接也可以被显示出来。
三个横杠是分割线 ---：
这是代码块（前后都加上 ```）：
```python print("hello") ```
这是引用（前面加上 > 和一个空格）：
`> 生存还是毁灭，这是一个问题。
——莎士比亚`
生存还是毁灭，这是一个问题。
——莎士比亚
这是各种不同的引用（不是所有编辑器都支持）：
`> [!NOTE]
生存还是毁灭，这是一个问题。
——莎士比亚
[!QUOTE]
生存还是毁灭，这是一个问题。
——莎士比亚
[!TIP]
生存还是毁灭，这是一个问题。
——莎士比亚
[!WARNING]
生存还是毁灭，这是一个问题。
——莎士比亚
[!TLDR]
生存还是毁灭，这是一个问题。
——莎士比亚
[!EXAMPLE]
生存还是毁灭，这是一个问题。
——莎士比亚`
这是分割线：
这是各种不同的列表：
`有序：
1. 第一个
2. 第二个
3. 第三个
无序：
- 第一个
- 第二个
- 第三个
待办（可以打勾）：
- [ ] 第一个
- [x] 第二个
- [ ] 第三个
有序的待办：
1. [ ] 第一个
2. [x] 第二个
3. [ ] 第三个`
LaTeX 公式，用 $$ 包裹的段落，写论文的同学可能会懂（不是所有编辑器都支持）：
$$ f(x)=\sum^{\infty}_{n=0}\frac{f^{(n)}(x_{0})}{n!}(x-x_{0})^n $$
Markdown 也支持表格，但是对我们来说很不方便。好在大多数编辑器都对表格做了特别的优化，我们不会亲自写这样的 markdown 代码。了解一下即可：
| 姓名 | 年龄 | 职业 | |------|------|------| | 张三 | 25 | 工程师 | | 李四 | 30 | 设计师 |
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
Markdown 当然还有很多刁钻的排版技巧以及注意事项，但是那些于我们而言大多数时候用不上，所以我就不在此多讲了。
有兴趣的读者可以在我的公众号回复 markdown 获取我整理的适用于 Obsidian 的完整版语法表（可能包含许多你从未想象过的新鲜用法）。
# 我用 markdown 做了什么？
在我个人看来，最有用的 markdown 格式是有序列表。有序列表有一个很好的特性，就是可以分层次，这使得有序列表可以一定程度上作为思维导图使用。
- 1. 第一层 1
- 1. 第二层
- 1. 第三层 1
- 2. 第三层 2
- 3. ……
- 2. 第一层 2
- 3. ……
因此，有序列表很适合用来编写 SOP 操作手册。把任务分解成大的步骤，每个大步骤再分解展开为小步骤，一目了然，不会出错：
用 markdown 制作的 SOP 还有一个不起眼但是好用的功能：快速复制粘贴。
英伟达 GPU 的驱动一直都不是很稳定（此处不得不提 Linux 之父的吐槽），有时候会因为各种原因突然出故障。这时候我就需要执行排障操作。为此我将操作总结为了 SOP：
点击代码块右上角，命令就会自动被复制到剪贴板上。然后我就可以快速将其粘贴到命令行执行，免去我用鼠标选中文本的麻烦。虽然这只是一个不值一提的小改进，但是对于体验的改善是极大的。
此外，如果你是苹果全家桶用户（有通用剪贴板功能），或者使用微信输入法打通的剪贴板限制，实现了「设备 A 复制内容，设备 B 粘贴内容」，快速复制带来的效率提升还能被继续放大。有机会我想专门用一期的长度来探究一下通用剪贴板这一效率神器，讲讲非苹果全家桶用户如何实现这一好用的功能。
此外，得益于目前几乎所有的 AI 都讲 markdown 的语言，markdown 编辑器比任何编辑器都要更加适合与 AI 融合到一起。比如当我想要系统性地练习算法的时候，我可以直接要求 ChatGPT 为我生成一份算法题单，我只需要直接复制到 Obsidian 即可。要实现同样的功能，不论是 Word、Excel 还是 Notion 都是不可能这样简单的：
读到这里，本文的主要目的就已经达到了。如果你感觉对你有用，可以点点关注+在看。接下来的内容我想留给有足够耐心且想深入了解这个话题的读者。
# 最后闲谈：常见问题 QA
问：Obsidian/Typora/...（某款支持 markdown 的编辑器）如何实现首行缩进/字体颜色/下划线/居中/文字环绕/调整图片大小/多栏/更换字体……（省略 114514 种 Word/WPS 特性）
对于用户来说，markdown 相对于 word 的主要优势是排版简单，其核心手段本质上是限制你能做出的排版选择。这是一种有一点父权色彩但是有效的手段：
- 1. 不让你改字体，你就无需操心字体，也不会使用难看的字体；
- 2. 不让你改字号/粗细/颜色，只允许你使用有限几个强调文本的手段（加粗、高亮、斜体），你就又可以少操心很多事情，并且不会因为选了不合理的排版把文章的视觉效果毁掉；
- 3. ……
这有点类似所谓设计上的极简主义：只要我什么都不加，那设计就丑不了（虽然也美不到哪去）。这也正是 markdown 最核心的好处：你无需花费心思在排版上，可以放心地把精力专注于内容。这也就是为什么我一直坚持使用 markdown 写作（我如何用markdown写作 (opens new window)）。
此外很有意思的是，markdown 虽然看起来古朴，但是实际上诞生于 2004 年，远远晚于 Microsoft Word 等一众富文本编辑器。一个更加简单的后来者能够杀出重围、走向火爆也许就说明了和复杂排版相对的「不想排版」的需求一样是广泛的。因此虽然上面这些需求在 Obsidian 都有方法实现，但是我仍然建议你在使用 markdown 的时候放下排版的执念，专注于你的写作。
问：Markdown 在各种编辑器里都兼容吗？
并不，而且事实上 markdown 的兼容性已经成为了一个大问题：支持 markdown 的编辑器多到你想不到：除了 Obsidian、Typora 这样有名有姓的 markdown 编辑器，Notion、语雀这样的富文本编辑器也支持一定的 markdown 语法；除此之外，各大图文内容网站（知乎、少数派、掘金等）也一样。最近甚至连 Windows 记事本也宣布了支持 markdown（虽然支持的语法很少）。
然而他们关于具体支持哪些特性、以及这些特性应该如何实现都有分歧。主要原因是 markdown 在 2004 年诞生之初并没有囊括现在这么多语法（比如数学公式），此后其又处于一个缺乏维护的状态，导致 markdown 不像 C++、Python 等编程语言一样有统一标准。为了实现必需的排版功能，目前各家编辑器基本上都推出了独属于自己的 markdown 语法，这导致你在一个地方写的笔记，换了编辑器之后有的部分就无法渲染。这形成了一种封建割据的状态。
在一众割据军阀之中，Github 算是影响力较大的那个。因此 Github 风格的 markdown （Github Flavored Markdown，GFM）也可以看作是普遍受支持 markdown 规则。如果要想自己写的东西不被一家套牢，你最好要避免使用 GFM 之外的 markdown 语法。