12 min read

我不允许我的粉丝不懂 Markdown

Source: http://x.com/i/article/2036276262151528448

我为什么会写这一篇门槛这么低的文章, 因为我认为所有的技术背景的人,都有义务让世界变更好一些,现在很多大厂的编辑工具,都不是原生支持 markdown, 实话说在我看来这太糟糕了, 如果越来越多的人都会使用AI时代这项通用的语言, 我们每个人都会因此受益。

markdown 是一项非常简单、简单到任何一个人,只需要10分钟就能掌握的语言。 当你读完这篇文章, 我相信你就已经学会了 markdown , 那么在接下来的工作和生活中,你唯一要做的就是去用他,让你的生活更美好。

丢弃 word 吧, 这简直就是垃圾。

人人都可享受的 MARKDOWN 红利

Markdown 不是程序员的专利,它是 AI 时代每个人都该掌握的「通用语言」。

你可能听过 Markdown,但觉得它是「程序员的东西」。

错了。

2024 年以来,ChatGPT、Claude、Gemini、DeepSeek……几乎所有主流 AI 的输入和输出,都基于 Markdown。当你跟 AI 对话时,AI 回复给你的加粗、列表、代码块、表格——全是 Markdown。

这意味着一件事:懂 Markdown 的人,和 AI 协作的效率是不懂的人的数倍。

这不是夸张,这是正在发生的事实。

一、MARKDOWN 从哪来?

2004 年,博客作者 John Gruber

和黑客 Aaron Swartz

一起设计了 Markdown。他们的出发点极其简单:让人能用纯文本写出好看的网页内容,而不用学 HTML。

John Gruber 当时在写博客,受够了 HTML 标签的繁琐——写个加粗要 ,写个列表要

    • 2008 年:GitHub 成立,选择 Markdown 作为文档标准格式(README.md),Markdown 开始在开发者社区普及
    • 2012 年:Stack Overflow 等技术社区全面支持 Markdown,它成为技术写作的事实标准
    • 2014 年:由于原始 Markdown 规范模糊,John MacFarlane 等人发布了 CommonMark 规范,统一了各家实现的差异
    • 2016-2020 年:Notion、飞书、语雀等新一代协作工具原生支持 Markdown,将其从程序员圈子带向大众
    • 2022 年至今:ChatGPT 发布,AI 时代到来——所有大语言模型的输出格式都是 Markdown,它从「技术工具」变成了「通用语言」
    • 不依赖任何软件:不像 Word 文档绑定 Microsoft Office,Markdown 文件用任何文本编辑器都能打开
    • 文件极小:一篇万字文章,Markdown 文件可能只有 20KB,Word 文档可能 2MB
    • 永不过时:20 年前的 .txt 文件今天照样能打开,Markdown 也一样。你 10 年前写的 Word 2003 文档呢?
    • 版本控制友好:程序员用 Git 管理代码,也用 Git 管理 Markdown 文档,每一次修改都有迹可循
    • 可以直接渲染成漂亮的网页
    • 可以导出为 PDF
    • 可以转换为微信公众号排版
    • 可以转换为 Word 文档
    • 可以变成幻灯片(PPT)
    • 可以发布到 GitHub、Notion、飞书、语雀……
    • 用标题理清层级
    • 用列表拆解要点
    • 用加粗标记重点
    • 用引用突出关键信息
    • 字体大小不统一
    • 标题样式乱了
    • 列表缩进对不齐
    • 粘贴过来的内容格式全乱了
    • 在 GitHub 上用 Markdown 写文档,团队成员可以直接提修改建议
    • 在飞书/Notion 中用 Markdown 快速编辑,不用鼠标点来点去
    • 写技术方案、会议纪要、项目文档,Markdown 都是最高效的选择
    • 写公众号:Markdown 写完 → 一键转换为公众号排版
    • 写技术博客:GitHub Pages、Hugo、Hexo 都基于 Markdown
    • 写电子书:用 Markdown 写,导出为 ePub 或 PDF
    • 做知识付费:课程大纲、讲义、笔记,全部用 Markdown 管理
    • 做 Newsletter:Substack、Revue 等平台都支持 Markdown
    • Markdown 官方文档 ( daringfireball.net/projects/markdown ) —— John Gruber 的原始规范,了解 Markdown 的设计初衷
    • CommonMark 规范 ( commonmark.org ) —— 现代 Markdown 的标准规范,解决了原始规范中的模糊之处
    • GitHub Flavored Markdown (GFM) 规范 ( github.github.com/gfm ) —— GitHub 扩展的 Markdown 规范,增加了表格、任务列表、删除线等实用语法
    • Markdown Tutorial ( markdowntutorial.com ) —— 最好的交互式入门教程,有中文版,边学边练,10 分钟上手
    • CommonMark 教程 ( commonmark.org/help/tutorial ) —— CommonMark 官方交互教程,10 个小课程覆盖核心语法
    • Markdown Guide ( markdownguide.org ) —— 最全面的 Markdown 参考网站,包含基础语法、扩展语法、工具推荐和速查表
    • GitHub Markdown 文档 ( docs.github.com/en/get-started/writing-on-github ) —— 如果你用 GitHub,这是最实用的参考
    • John Gruber 的博客 Daring Fireball ( daringfireball.net ) —— Markdown 的发明者,Apple 生态最知名的科技博主之一
    • 纪录片《互联网之子》(The Internet's Own Boy) —— 讲述 Aaron Swartz 的故事,Markdown 的联合设计者、Reddit 联合创始人、互联网自由活动家,26 岁英年早逝

。他想要一种「写起来像纯文本,渲染出来像网页」的格式。Aaron Swartz(Reddit 联合创始人、RSS 规范贡献者、互联网自由活动家)帮他完善了语法规范。Markdown 的设计哲学只有一条:可读性优先。 即使不渲染,Markdown 的源文件也应该能直接阅读,不会被符号淹没。这个看似简单的发明,在之后的 20 年里改变了整个互联网的写作方式:一个原本为博客设计的轻量标记语言,在 20 年后成了人类与 AI 沟通的桥梁。这大概是 Gruber 和 Swartz 当年没有想到的。

Image

二、为什么 MARKDOWN 成了 AI 时代的宠儿?

1. AI 的「母语」就是 Markdown

所有大语言模型的训练数据中,Markdown 格式的内容占比极高——GitHub 上的 README、技术文档、维基百科的结构化内容,全部是 Markdown。AI 不只是「能读懂」Markdown,它是用 Markdown 思考的。你给 AI 一段纯文本,它回复你的是带标题、列表、加粗的结构化内容。你给 AI 一段 Markdown 格式的提示词,它的理解准确度会显著提升。这就像跟一个外国人沟通——你用他的母语说话,效果当然更好。

2. 纯文本的终极优势

Markdown 的本质是带格式的纯文本。这意味着:

3. 「写一次,到处用」

同一份 Markdown 文件:一次书写,多平台分发。这在内容创作领域是巨大的效率红利。

三、学会 MARKDOWN,你能获得什么?

🔧 能力层面:成为「结构化表达」高手

大多数人写东西是「一坨文字」——没有标题层级、没有列表分点、没有重点标记。Markdown 强迫你用结构化的方式思考和表达:结构化表达能力,是职场中最被低估的核心竞争力之一。无论你是写周报、写方案、写邮件,还是写文章,结构清晰的内容永远比一堆文字更有说服力。当你学会了用 Markdown,你就能理解为什么技术背景出身的人,整天会喷各大厂的文章编辑器就是一坨翔了——臃肿、卡顿、格式混乱、粘贴进去排版全炸。用惯了 Markdown 的人再去用那些富文本编辑器,就像开惯了手动挡再开自动挡的人被迫去骑一辆链条生锈的共享单车。

⚡ 效率层面:告别格式焦虑

用 Word 写文章,你有多少时间花在了「调格式」上?Markdown 让你彻底专注于内容。格式?几个符号就搞定了。标题用 #,加粗用 **,列表用 -。就这么简单。写完之后,选一个主题模板,一键渲染,格式完美统一。你再也不用在 Word 里跟格式刷较劲了。

🤝 沟通层面:跟 AI 和团队高效协作 跟 AI 协作 当你用 Markdown 格式给 AI 写提示词:

markdown

# 任务
帮我写一篇产品分析文章
​
## 要求

- 字数:2000 字

- 风格:专业但易懂

- 结构:问题 → 分析 → 结论
​
## 参考信息

- 产品名称:XXX

- 目标用户:25-35 岁职场人

AI 对这种结构化输入的理解,远优于你写一段「帮我写篇文章,大概 2000 字,分析一下 XXX 产品,要专业但易懂……」的自然语言。

跟团队协作

💰 变现层面:内容创作的基础设施如果你是内容创作者,Markdown 是你的基础设施:内容创作者的核心工作流:Markdown 写作 → 多平台分发。掌握 Markdown,你就掌握了这条工作流的起点。

四、10 分钟学会 MARKDOWN(80% 高频用法)

学 Markdown 要一周?No,你只需要 10 分钟就够了。当你读完下面这一节,你就已经学会了。恭喜你,这 10 分钟,会让你受益一辈子。Markdown 的全部语法可能有上百条,但你日常只需要掌握以下这些,就能覆盖 80% 的使用场景。

1. 标题

markdown

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

技巧:一篇文章通常只用到一级到三级标题。# 后面要有一个空格。

2. 段落与换行

段落之间空一行即可。如果只想换行不分段,在行末加两个空格再回车。这是第一段。 ​ 这是第二段。

3. 加粗与斜体

markdown

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

效果:这是加粗、这是斜体、这是加粗斜体、这是删除线

4. 列表

无序列表(用 -、* 或 +):markdown


- 第一项

- 第二项
  - 子项(前面加两个空格)
  - 另一个子项

- 第三项

有序列表:markdown

1. 第一步
2. 第二步
3. 第三步

任务列表(待办事项):markdown


- [x] 已完成的任务

- [ ] 未完成的任务

- [ ] 另一个待办

5. 链接与图片

链接文字 ​

图片描述

6. 引用

markdown

> 这是一段引用
> 可以有多行
>
> > 还可以嵌套引用

效果:

这是一段引用,通常用于强调重要信息或引用别人的话。

7. 代码

行内代码:用反引号包裹使用 `print("hello")` 输出文字代码块:用三个反引号包裹,可以指定语言plaintext


python
def hello():
    print("Hello, World!")

8. 表格

plaintext

| 功能 | Markdown | Word |
|------|----------|------|
| 学习成本 | 低 | 中 |
| 格式控制 | 符号 | 鼠标 |
| AI 友好度 | ★★★★★ | ★★ |

效果:

Image

9. 分割线

三个或以上的 -、* 或 _ 都可以。

---

10. 脚注

markdown

这是一个有脚注的句子[^1]。
​
[^1]: 这是脚注的内容。

速查表

Image

这 10 个语法,就是你需要的全部。花 10 分钟练一遍,你就入门了。

五、MARKDOWN 软件推荐

📝 写作工具

Image

🌐 在线工具

Image

🤖 AI 工具(天然 Markdown)

Image

📚 发布平台(原生支持 Markdown)

GitHub、GitBook、Hashnode、Substack、 DEV.to 、掘金、思否(SegmentFault)、少数派……

六、MARKDOWN 学习资源

📖 官方与经典

🎓 交互式教程

📚 进阶参考

🔬 了解创始人

七、从今天开始

不需要花一周学 Markdown。你只需要:选一个工具——推荐 Typora(最直观)或 Obsidian(最全能)记住 5 个符号——# 标题、** 加粗、- 列表、> 引用、` 代码写一篇东西——把你下一次要写的周报、笔记、文章,用 Markdown 写就这样。10 分钟后,你就会发现自己回不去 Word 了。Markdown 的红利不在于它有多复杂,恰恰相反——它的红利在于它足够简单,简单到人人都能学会,却强大到覆盖你 90% 的写作场景。在 AI 时代,掌握 Markdown 不是加分项,而是基本功。越早学会,越早享受红利。这篇文章本身,是用 Markdown编写的。

Image