你好,欢迎翻开这本书。
我猜你点开这本书,可能是听到身边人都在说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 的基本原理
其实就两步,没了:
- 你写作的时候:用简单的符号把格式标记好 2 工具显示的时候:自动把这些符号转换成漂亮的排版
就这么简单。你不用管后面它是怎么转换的,你只要标记好,剩下的交给工具就行了。
1.2 Markdown vs Word
你可能会说:我用Word用得好好的,为什么要换这个Markdown?
好问题。我给你掰扯掰扯,你听完就明白了。
先给你看个对比表,一目了然:
| 功能 | Word | Markdown |
|---|---|---|
| 学习难度 | 复杂,一大堆功能要学 | 简单,就记几个符号 |
| 文件大小 | 很大,一篇文章动不动几十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一下子就看懂你的要求了,不会跑偏。
给你几个实用小技巧
- 目标要明确 一句话说清楚你想让AI做什么,别绕弯子。模糊的要求只能得到模糊的结果。
- 给够上下文 说说这个任务是干什么用的,目标读者是谁,这些信息AI都需要。
- 给个示例 如果你有喜欢的风格,贴一段示例给AI看,它就知道你想要什么感觉了。
就这么简单。按照这个结构写提示词,输出质量会高很多。
日常练习
现在你也可以试着写一个Markdown格式的提示词,模板给你放这了:
# 任务:[你想让AI做什么]
# 要求
- [第一个具体要求]
- [第二个具体要求]
# 背景说明
[任务的来龙去脉]
# 格式要求
[你想要什么样的输出格式]
写好发给AI试试,看看效果是不是比你以前乱写要好。
1.5 动动手,第一次写Markdown
光看不练假把式,看完这一章,我们来动手做点练习,五分钟就能做完。做完你就对Markdown有概念了。
1.5.1 练习1:创建你的第一个文档
目标:写出你的第一个Markdown文档
步骤:
- 打开任意文本编辑器,系统自带的记事本就行
- 输入下面这段内容: # 我的第一个Markdown文档
这是我第一次用Markdown写作。
## 学习Markdown的三个好处
1. 学习简单,半小时就能会
2. 文件很小,不占空间
3. AI特别喜欢
## 下一步
我要继续往下学! - 保存文件,名字就叫
my-first-markdown.md - 用支持Markdown的工具打开看看效果
做完你就会发现:哦,原来Markdown就这么回事啊。挺简单的。
1.5.2 练习2:给文档加点格式
目标:试试加粗、斜体、代码块
步骤:
- 打开刚才保存的文件
- 在文件末尾加上这段: ## 重点强调
Markdown真的很简单,**半小时就能学会**。
不信你试试,*保证不后悔*!
## 代码示例
如果你会一点Python,试试写个Hello World:
“`python
print(“Hello, Markdown!”)看到代码高亮了吗?是不是挺酷的? - 保存一下,再打开看看效果
这样你就学会了加粗、斜体和代码块,三个最常用的格式。
1.5.3 练习3:比比文件大小
目标:亲身感受一下Markdown文件有多小
步骤:
- 打开Word,写一篇两百字的文章,保存,看看文件多大
- 同样的内容,用Markdown保存,再看看文件多大
对比一下你就知道了,Markdown文件通常只有Word的十分之一大小,有时候更小。
本章重点总结
学完这一章,你应该记住这几点:
Markdown就是用简单符号标记排版的写作方式,不是编程语言,一点都不难。
它的核心优势:
- 学习成本低,半个小时真的能入门
- 文件特别小,存着发送都方便
- 纯文本,版本管理特别方便
- 排版稳定,在哪里打开都不会乱
在AI时代,Markdown更好用了:
- AI天生就会生成Markdown格式
- 配合AI写作,能让你的效率翻倍
- 用Markdown写提示词,AI理解得更准
学会了这些,你已经明白为什么要学Markdown了。下一章,我们来学具体的语法,看完你就能动手写了。准备好了吗?我们继续。