第一章:为什么选择 Markdown

你好,欢迎翻开这本书。

我猜你点开这本书,可能是听到身边人都在说Markdown,说它写东西怎么怎么好,但你心里还是有点打鼓:

这玩意儿是什么?听起来怪怪的,难不难学?我一个普通人,需要用这个吗?

别担心,这一章我就给你讲明白,为什么在AI时代,每个人都应该学学Markdown。真的不难,半小时就能学会基础,学会了能省你好多时间。


1.1 什么是 Markdown

1.1.1 简单理解 Markdown

别被这个名字吓到了。

Markdown真的超级简单,一句话就能说清楚:它就是一种用简单符号来排版的写作方式。

你肯定有过这种经历:写文章想让某个词加粗,得放下键盘,拿起鼠标,找到工具栏上那个”B”按钮,点一下才能生效。写完了,如果还要加粗,又得重复一遍。

在Markdown里,不用这么麻烦。你想让文字变粗,直接在文字前后各加两个星号 ** 就行了。就像这样:

 普通文字
 **加粗文字**

手不用离开键盘。一分钟就能习惯。就这么简单。

1.1.2 Markdown 不是编程语言

很多人一听”Markdown”,带个”down”,第一反应就是:这是编程吧?我学不会。

放轻松。

Markdown真不是编程语言,它跟编程一点关系都没有。你根本不需要什么编程基础。只需要记住几个简单的符号,就像记住加减乘除一样简单。

1.1.3 给你打个比方

我这么说你可能还是觉得有点抽象,我给你打个生活中的比方:

  • 你平时用Word,就像是在Word里直接写字排版,你看到什么样,保存下来就是什么样。这叫”所见即所得”。
  • 你用Markdown,就是用一些简单的符号告诉你的工具:这里是标题,这里要加粗,这里是列表。工具会自动帮你转换成漂亮的排版。

这么说吧,这就像你写邮件的时候,会用表情符号表达心情:😊 代表开心,😢 代表难过。

Markdown也是一样,它用”排版符号”代替了鼠标点来点去。用 # 代表标题,用 ** 代表加粗。就这么简单。

1.1.4 Markdown 的基本原理

其实就两步,没了:

  1. 你写作的时候:用简单的符号把格式标记好 2 工具显示的时候:自动把这些符号转换成漂亮的排版

就这么简单。你不用管后面它是怎么转换的,你只要标记好,剩下的交给工具就行了。


1.2 Markdown vs Word

你可能会说:我用Word用得好好的,为什么要换这个Markdown?

好问题。我给你掰扯掰扯,你听完就明白了。

先给你看个对比表,一目了然:

功能WordMarkdown
学习难度复杂,一大堆功能要学简单,就记几个符号
文件大小很大,一篇文章动不动几十MB很小,纯文本才几KB
版本管理麻烦,二进制文件不好对比简单,纯文本随便改
排版稳定性容易乱,不同版本打开可能不一样稳定,在哪打开都一样
AI兼容性一般,AI处理起来麻烦超好,AI天生就爱它

接下来我细说一下,用Markdown到底好在哪里。

1.2.2 Markdown 的优势

我用了几年Markdown,最大的感受就是这几点:

学习成本低

半小时就能学会基础语法。真的,我不骗你。就那几个符号,看完第二章你就能上手。不需要记复杂的快捷键,符号本身就很直观,一看就懂。

文件超级小

同样一篇博客文章,Word可能要5MB,Markdown只要50KB。差了一百倍。存在云盘不占空间,发邮件附件秒发。

版本控制友好

如果你需要经常修改文章,存在Git里,每次改了什么,一目了然。想退回到之前的版本,一句话的事儿。Word是二进制文件,根本没法这么玩。

排版稳定清晰

不会遇到Word那种莫名其妙的格式错乱——你明明没改,打开怎么就跑位了?这种破事儿,用Markdown不会有。在电脑上打开是什么样,在手机上打开还是什么样。代码块、表格、公式,都支持得很好。

转换方便

你写好一份Markdown,想要PDF就能导出PDF,想要HTML就能导出HTML,想要Word也能转Word。一个源文件,想用在哪里就用在哪里。

1.2.3 Word 的痛点

说句实话,Word在很多场景下,真的不太好用。我总结了几个普通人都会遇到的痛点:

格式容易错乱

不同版本的Word打开同一个文件,格式可能就变了。从别的地方复制粘贴过来,总会带进去你不想要的格式,删半天删不干净。调个排版,比写内容还累。

文件太大

就算你没写多少内容,Word文件也小不了。存多了挺占地方的,发邮件有时候还会因为太大发不出去。

长文档管理麻烦

几百页的Word,打开都要加载半天。想找某一段内容,搜索起来也慢。结构化的内容,展示起来真的不方便。

技术内容支持不好

如果你要写点技术文章,放点代码进去,Word里代码块怎么看怎么丑。数学公式支持也弱。真不如Markdown方便。

1.2.4 实际场景对比

我拿几个日常场景给你对比一下,你就明白差距了:

场景1:写博客文章

  • Word:排版→调整→再调整,折腾半天,最后发布到网站上格式还不对。
  • Markdown:写完直接复制粘贴,格式完美,直接就能发。

场景2:写学习笔记

  • Word:分类整理麻烦,查找也不方便,一大堆文件找不到。
  • Markdown:结构清晰,搜索很快,现在流行的双链笔记,原生就支持Markdown。

场景3:团队一起写文档

  • Word:多人编辑,一不小心就保存出好几个版本,文件名都是”文档v1″”文档最终””文档_最终改完”,乱死了。格式还容易冲突。
  • Markdown:纯文本,合并起来很简单,配合Git管理,谁改了什么清清楚楚。

场景4:写技术文档

  • Word:代码块显示难看,公式支持不好。
  • Markdown:代码高亮完美,什么语言都支持,数学公式也没问题。

看吧,在这些日常场景里,Markdown用起来就是比Word舒服。


1.3 AI 时代的 Markdown

现在我们进入AI时代了,这一点特别重要。Markdown在AI时代,比以前更有用了。

1.3.1 AI 协作的新方式

你应该用过ChatGPT、智谱AI、文心一言这些AI助手吧?

不知道你有没有发现一个现象:AI特别擅长生成结构化的内容。

你让AI写一篇文章,它输出的内容天然就是有结构的——有标题,有列表,有段落。

而这些,正好就是Markdown最擅长表达的。

1.3.2 为什么 AI 更喜欢 Markdown

为什么AI生成内容,都爱用Markdown?三个原因:

结构清晰,AI容易理解

Markdown用符号标记结构,哪个是标题,哪个是列表,AI一眼就能看明白。生成出来的内容结构自然也就清楚。

纯文本格式,AI处理方便

AI本来就是处理文本的,纯文本就是它最顺手的格式。不需要处理Word那种复杂的二进制格式,处理快,不容易错。

跨平台兼容,发方便

Markdown转HTML很简单,不管你要发博客、发公众号、发技术社区,都能用。AI生成完,你拿过来就能用,不用怎么改格式。

1.3.3 人类和AI一起写作,有多爽

用Markdown配合AI写作,体验真的特别好。我给你举几个常见用法:

快速生成初稿

你给AI一个主题,比如”写一篇北京三天两夜旅行攻略”,几秒钟它就能给你生成一篇完整的Markdown。结构都给你搭好了,你只要微调一下,加点自己的感受,就完事了。不用从零开始写。

优化现有内容

你写了一段文字,觉得写得不好,直接把这段Markdown发给AI:”帮我润色一下这段文字,说得更通俗一点”。AI分分钟给你一个优化好的版本。

接着你的思路往下写

你写一半卡壳了,不知道接下来该说什么,把已经写好的Markdown发给AI:”帮我接着这段往下写,讲讲XX”。AI顺着你的思路就能接着写,无缝衔接。

格式转换

你有个Word文档想转成Markdown,扔给AI:”帮我把这段Word内容转成标准Markdown格式”,分分钟给你转好。

就这么简单。AI帮你干脏活累活,你负责把控方向和添加个人体验,写作效率真的能翻倍。

1.3.4 举个实际例子

我给你看一段真实的对话,你感受一下:

 你:帮我写一篇关于"AI时代为什么要学Markdown"的文章开头,用Markdown格式。
 ​
 AI(三秒钟后):
 ​
 # AI时代为什么要学Markdown
 ​
 ## 引言
 ​
 在AI工具越来越普及的今天,写作者的工具链也在发生变化...
 ​
 ## 什么是Markdown
 ​
 Markdown是一种轻量级的标记语言...

你拿到这个开头,觉得不满意,改改措辞,加点自己的话,直接就能用。省了你多少搭框架的时间。

再比如,你上课记笔记,整理PPT,把PPT内容扔给AI:”帮我整理成一份Markdown格式的学习笔记”。AI直接给你整理好结构,标题、要点、重点都给你分清楚。你直接保存就能复习。

真的,用过一次你就知道有多爽。


1.4 Markdown 能用在哪些地方

说了这么多,Markdown具体能用到哪些地方?其实真的挺多的,我给你数数:

1.4.1 常见写作场景

写博客、写技术文章

现在几乎所有技术社区,掘金、知乎、CSDN、博客园,都支持Markdown。你写完直接复制粘贴,格式完美,不用再调。代码高亮、表格、公式,都没问题。

记笔记

现在主流的笔记软件,Obsidian、语雀、飞书,全都支持Markdown。想做双链笔记,Markdown是原生格式。图片、表格、公式,都能放。

写文档

写技术文档、API文档、项目说明,GitHub上所有README都是Markdown。版本控制友好,谁都能改。

写邮件

有些邮件客户端直接支持Markdown,写出来的邮件结构清晰,比乱哄哄的纯文本好看多了,发出去自动转成HTML。

做简历

用Markdown写简历,格式清晰,改起来方便,能随时导出PDF。方便版本管理,你可以盯着你的简历一直优化。

写项目README

现在GitHub上所有开源项目,README都是Markdown。GitHub自动渲染,项目介绍一目了然,这已经是行业标准了。

1.4.2 和 AI 协作写作

这是Markdown在AI时代的新玩法,也是这本书想重点讲给你的。

AI能帮你做这些:

  • 快速帮你搭好文章大纲
  • 帮你扩展段落内容
  • 帮你优化文字表达
  • 帮你检查语法错误
  • 帮你生成案例和例子

这些我们后面的章节会详细讲,告诉你具体怎么用AI辅助你写Markdown。

1.4.3 AI 辅助你学习Markdown

不止写作,AI还能帮你学Markdown。

你哪里不懂,直接问AI:”这个格式在Markdown里怎么写?”,它当场就能给你举例子。还能给你出练习题,帮你检查答案,讲解知识点。比自己啃教程快多了。

1.4.4 用Markdown写提示词,效果更好

如果你在用像OpenClaw这样的AI助手,用Markdown写提示词,有巨大优势。

我总结了三个好处:

结构清晰

用标题组织提示词的结构,用列表一条一条列出你的要求,用代码块放示例。AI一眼就能看明白你想要什么。

容易维护

纯文本,改起来方便,存在Git里也能版本管理。你可以把常用的提示词存起来,下次要用直接拿过来改一改就能用,复用很方便。

AI理解得更准

结构化的提示词,歧义少。AI不容易误解你的意思,输出准确度自然就高。

我给你看一个合格的Markdown提示词应该是什么样的:

 # 任务描述
 帮我写一篇关于旅行攻略的文章。
 ​
 # 要求
 - 用Markdown格式
 - 包含这几个章节:行前准备、行程安排、美食推荐、住宿建议
 - 字数大概一千字左右
 ​
 # 格式说明
 - 小标题用三级标题 ###
 - 景点列表用无序列表
 - 代码块要指定语言
 ​
 # 参考风格
 类似这种轻松的旅行笔记风格

这样写,AI一下子就看懂你的要求了,不会跑偏。

给你几个实用小技巧

  1. 目标要明确 一句话说清楚你想让AI做什么,别绕弯子。模糊的要求只能得到模糊的结果。
  2. 给够上下文 说说这个任务是干什么用的,目标读者是谁,这些信息AI都需要。
  3. 给个示例 如果你有喜欢的风格,贴一段示例给AI看,它就知道你想要什么感觉了。

就这么简单。按照这个结构写提示词,输出质量会高很多。

日常练习

现在你也可以试着写一个Markdown格式的提示词,模板给你放这了:

 # 任务:[你想让AI做什么]
 ​
 # 要求
 - [第一个具体要求]
 - [第二个具体要求]
 ​
 # 背景说明
 [任务的来龙去脉]
 ​
 # 格式要求
 [你想要什么样的输出格式]

写好发给AI试试,看看效果是不是比你以前乱写要好。


1.5 动动手,第一次写Markdown

光看不练假把式,看完这一章,我们来动手做点练习,五分钟就能做完。做完你就对Markdown有概念了。

1.5.1 练习1:创建你的第一个文档

目标:写出你的第一个Markdown文档

步骤

  1. 打开任意文本编辑器,系统自带的记事本就行
  2. 输入下面这段内容: # 我的第一个Markdown文档
     ​
     这是我第一次用Markdown写作。
     ​
     ## 学习Markdown的三个好处
     ​
     1. 学习简单,半小时就能会
     2. 文件很小,不占空间
     3. AI特别喜欢
     ​
     ## 下一步
     ​
     我要继续往下学!
  3. 保存文件,名字就叫 my-first-markdown.md
  4. 用支持Markdown的工具打开看看效果

做完你就会发现:哦,原来Markdown就这么回事啊。挺简单的。

1.5.2 练习2:给文档加点格式

目标:试试加粗、斜体、代码块

步骤

  1. 打开刚才保存的文件
  2. 在文件末尾加上这段: ## 重点强调
     ​
     Markdown真的很简单,**半小时就能学会**
     ​
     不信你试试,*保证不后悔*
     ​
     ## 代码示例
     ​
     如果你会一点Python,试试写个Hello World:
     ​
     “`python
     print(“Hello, Markdown!”)看到代码高亮了吗?是不是挺酷的? ​
  3. 保存一下,再打开看看效果

这样你就学会了加粗、斜体和代码块,三个最常用的格式。

1.5.3 练习3:比比文件大小

目标:亲身感受一下Markdown文件有多小

步骤

  1. 打开Word,写一篇两百字的文章,保存,看看文件多大
  2. 同样的内容,用Markdown保存,再看看文件多大

对比一下你就知道了,Markdown文件通常只有Word的十分之一大小,有时候更小。


本章重点总结

学完这一章,你应该记住这几点:

Markdown就是用简单符号标记排版的写作方式,不是编程语言,一点都不难。

它的核心优势:

  • 学习成本低,半个小时真的能入门
  • 文件特别小,存着发送都方便
  • 纯文本,版本管理特别方便
  • 排版稳定,在哪里打开都不会乱

在AI时代,Markdown更好用了:

  • AI天生就会生成Markdown格式
  • 配合AI写作,能让你的效率翻倍
  • 用Markdown写提示词,AI理解得更准

学会了这些,你已经明白为什么要学Markdown了。下一章,我们来学具体的语法,看完你就能动手写了。准备好了吗?我们继续。