上一章我们讲明白了为什么要学Markdown,这一章我们动手学。
别紧张,Markdown的基础语法真的超级简单。我保证,你坐着喝杯茶的功夫就能看完,看完就能动手写。
我们一个一个来,不急。
2.1 标题和段落
我们从最基础的开始——标题和段落。这是你写任何文章都离不开的。
2.1.1 标题怎么写
Markdown用井号 # 来表示标题。几个井号就是几级标题:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一个井号最大,是文章的主标题。六个井号最小,一般用不到这么多级。
实际效果就是这样:
一级标题(最大,文章标题用这个)
二级标题(章节标题用这个)
三级标题(小节标题用这个)
很简单吧?就是数字越大,标题越小。就这么记。
2.1.2 段落怎么分
段落更简单,你直接写文字就行。唯一要记住的就是:两段之间空一行。
这是第一段文字。
这是第二段文字。
这是第三段文字。
如果你不空行,Markdown会把它们当成同一段。所以记得,写完一段,敲两下回车,空一行再写下一段。
2.1.3 给新手的几个小建议
我写了几年Markdown,总结了几个实用小经验,新手照着做就不会错:
一篇文章一般只有一个一级标题
一级标题就是文章的标题,放在最开头。后面的章节用二级标题,小节用三级标题,这样结构就清晰了。不要跳级,比如从一级直接跳到四级,读者看着晕。
段落不要太长
一大坨文字挤在一起,谁看着都累。一个段落最好不超过三到四行,分成短段落,读起来轻松。空行分隔,视觉上也清爽。
标题要简洁
别写几十字的长标题,几句话说清楚你这一段讲什么,就够了。标题就是给读者看结构的,太长篇幅反而是负担。
2.2 文字格式:粗体、斜体那些事儿
学会标题和段落,接下来我们学学怎么给文字加点样式——比如粗体、斜体这些。都很简单。
2.2.1 粗体
想让文字加粗?很简单,在文字前后各加两个星号 **:
这是**粗体文字**。
效果出来就是这样:这是粗体文字。
2.2.2 斜体
斜体就是一个星号 *,前后各一个:
这是*斜体文字*。
效果:这是斜体文字。
2.2.3 既粗又斜
既要粗又要斜?三个星号 *** 搞定:
这是***粗斜体文字***。
效果:这是粗斜体文字。
2.2.4 删除线
有时候你想表示”这段内容删掉了”或者”这个不对了”,用删除线。两个波浪线 ~~ 包起来就行:
这是~~删除线文字~~。
效果:这是删除线文字。
2.2.5 练习一下
把这几个组合起来试试,你就会用了:
# 我的练习笔记
今天学习了Markdown的基础文字格式。
## 几种格式
- **粗体**:用来强调重要内容
- *斜体*:有时候用来表示引用或者特别说明
- ***粗斜体***:特别重要的内容才用
-~~删除线~~:表示已经过时或者删掉的内容
## 实际用起来
写文章的时候,**粗体**用来给小标题做强调特别方便,*斜体*用来引用别人的话也很自然。
你把这段存成 .md 文件打开看看效果,是不是比纯文字好看多了?
2.3 列表:把要点一条一条列清楚
写东西,经常需要列要点。Markdown做列表特别方便。
2.3.1 无序列表
顺序不重要,就用无序列表。减号 - 开头,后面加个空格,接着写内容:
- 买买菜
- 做做饭
- 散散步
出来就是这样:
- 买买菜
- 做做饭
- 散散步
你也可以用星号 * 或者加号 + 开头,效果一样,看你喜欢。我个人习惯用减号,看着干净。
2.3.2 有序列表
顺序很重要,比如步骤一二三,就用有序列表。数字加点 1. 开头:
1. 第一步:打开冰箱门
2. 第二步:把大象放进去
3. 第三步:关上冰箱门
效果:
- 第一步:打开冰箱门
- 第二步:把大象放进去
- 第三步:关上冰箱门
就这么简单。数字不用管顺序对不对,工具会自动帮你排好,你哪怕全写成 1.,它也会自动编号。当然,自己按顺序写看着清楚。
2.3.3 嵌套列表
列表还能嵌套,大要点里面套小要点。怎么弄?嵌套的那一层前面加四个空格或者一个Tab就行:
- 今天要做的事
- 上午:写文章
- 下午:去超市
- 买苹果
- 买牛奶
- 明天要做的事
- 整理照片
效果:
- 今天要做的事
- 上午:写文章
- 下午:去超市
- 买苹果
- 买牛奶
- 明天要做的事
- 整理照片
层次一下子就清楚了。
2.3.4 任务列表
做待办事项,Markdown有专门的任务列表格式。用减号加方括号:
- 没完成的就是
- [ ] - 已经完成的就是
- [x]
- [ ] 买牛奶
- [x] 买面包
- [ ] 去银行
效果:
- 买牛奶
- 买面包
- 去银行
是不是一目了然?看着特别舒服。我每天的待办事项都这么写。
2.3.5 自己练一遍
看完了,自己动手写一个今日待办:
# 今日待办
## 工作
- [x] 写完项目文档
- [ ] 开产品会
- 准备PPT
- 打印材料
- [ ] 提交周报
## 学习
1. 看完第二章语法
2. 做练习
3. 写一篇短文
## 购物
- 苹果
- 牛奶
- 蔬菜
写完打开看看,是不是挺像回事?
2.4 代码块:写技术内容离不开
如果你要写点技术文章,放点代码,代码块是必不可少的。Markdown对这个支持特别好。
2.4.1 行内代码
一句话里面提到代码或者命令,用反引号 ` 包起来。就是键盘左上角那个键。
在Markdown里,`#` 是标题,`**` 是粗体。
效果就是这样:在Markdown里,# 是标题,** 是粗体。
这样和普通文字区分开,读者一眼就能看出来这是代码。
2.4.2 大段代码
大段代码,用三个反引号 “` 包起来,开头那三个反引号后面可以写上编程语言的名字,这样能语法高亮。
```python
def hello():
print("Hello, Markdown!")
hello()
```
效果出来就是这样,不同颜色关键字都给你标好了:
def hello():
print("Hello, Markdown!")
hello()
常用的语言,Markdown都支持。比如写Python就写 python,写JavaScript就写 javascript,写Shell命令就写 bash。写上语言,代码看着特别清楚。
2.5 表格:整齐放数据
做个对比表、计划表,放一些结构化数据,Markdown也能做表格,而且不难。
2.5.1 最简单的表格
基本格式就是这样:
| 姓名 | 年龄 | 职业 |
|------|------|------|
| 张三 | 28 | 工程师 |
| 李四 | 32 | 设计师 |
竖线 | 分隔每一列,第二行用减号 - 分隔表头和内容。效果就是这样:
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 28 | 工程师 |
| 李四 | 32 | 设计师 |
其实你哪怕不对齐,Markdown也能识别。比如你写成这样:
| 姓名 | 年龄 | 职业 |
|--|--|--|
| 张三 | 28 | 工程师 |
| 李四 | 32 | 设计师 |
出来效果一样。当然,你自己写的时候对齐了,看着方便改。
2.5.2 控制对齐方式
你还可以控制表格内容的对齐方式,在减号那边加点冒号就行:
:---表示左对齐:---:表示居中---:表示右对齐
| 名称 | 价格 | 库存 |
|:-----|:----:|------:|
| 苹果 | 5元 | 100 |
| 香蕉 | 3元 | 200 |
效果:
| 名称 | 价格 | 库存 |
|---|---|---|
| 苹果 | 5元 | 100 |
| 香蕉 | 3元 | 200 |
价格居中,数字右对齐,看着就是专业。
2.5.3 做个计划表练练手
我们来做一个周计划表格,练练手:
# 本周工作进度
| 星期 | 任务 | 完成状态 |
|:-----|:-----|---------:|
| 周一 | 学习Markdown | ✅ 完成 |
| 周二 | 做完所有练习 | ✅ 完成 |
| 周三 | 写第一篇文章 | 🔄 进行中 |
| 周四 | 总结复盘 | ⏳ 还没开始 |
是不是挺清楚的?做计划、做对比,用表格都特别方便。
2.6 引用:把别人的话单独放出来
你想引用一句名言,或者转引一段别人的话,用引用格式。Markdown用大于号 > 开头。
2.6.1 最简单的引用
> 学习不是注满一桶水,而是点燃一把火。
效果就是这样,会自动缩进,和你的正文区分开:
学习不是注满一桶水,而是点燃一把火。
2.6.2 多行引用
如果是好几行,每一行前面都加 > 就行。段落之间也要空行:
> 这是第一段引用。
>
> 这是第二段引用。
> 这还是第二段的第二行。
效果:
这是第一段引用。
这是第二段引用。 这还是第二段的第二行。
2.6.3 嵌套引用
引用里面还能套引用,多一个 > 就是更深一层:
> 作者原文说:
>
> > Markdown真的很简单。
>
> 我觉得他说的对。
效果:
作者原文说:
Markdown真的很简单。
我觉得他说的对。
层次分明,看着清楚。
2.7 分隔线:把内容分块
你想把文章分成几个部分,让读者一目了然,加个分隔线就行。三个或者更多减号、星号都行:
---
***
___
这三个效果都一样,出来就是一条水平线,把内容隔开。我习惯用 ---,好记。
就像这样,是不是一下子就把内容切开了?读起来逻辑更清楚。
2.8 常见错误,新手容易踩坑
我整理了几个新手最容易犯的错误,你提前看看,就能避开这些坑。
2.8.1 忘记空行分隔段落
这是最多人犯的错:
❌ 错的写法:
这是第一段。
这是第二段。
这样Markdown会把两段当成一段。因为它认空行分隔。
✅ 正确写法:
这是第一段。
这是第二段。
记得,写完一段,敲两下回车。养成习惯就好了。
2.8.2 列表写完忘记空行
你列完表,接着写正文,记得在列表后面空一行:
❌ 错的写法:
- 第一项
- 第二项
这里已经不是列表了,但它会被当成列表项。
✅ 正确写法:
- 第一项
- 第二项
这里已经不是列表了,这样就对了。
不然,后面的正文会被Markdown当成列表的一部分,出来格式就错了。
2.8.3 代码块忘记写语言
❌ 错的写法:
```
print("hello")
```
这样没有语法高亮,看着不好看。
✅ 正确写法:
```python
print("hello")
```
写上语言名,关键字就会高亮,代码看着清楚多了。
2.9 综合练习:把学到的都用一遍
学完了所有基础语法,我们来个综合练习,把今天学的都用上。做完这个练习,你就出师了。
练习1:写一篇学习心得
把这段抄进去,自己写一遍,看看效果:
# 我的Markdown学习心得
## 为什么开始学Markdown
昨天听朋友说Markdown写东西特别方便,我也来试试。
## 今天学了这些
### 基础格式
- `#`:标题
- `**`:粗体
- `*`:斜体
### 列表和表格
1. 无序列表用 `-`
2. 有序列表用 `1.`
3. 表格用 `|` 分隔列
## 我的感受
> 半小时就能学会所有基础语法,真的比Word简单太多了。
>
> > 我觉得,写作就应该专注内容,格式交给工具。
## 下一步计划
- [ ] 写完这篇心得
- [ ] 写一篇真正的博客
- [ ] 分享给朋友
---
**加油,继续往下学!**
练习2:写一份Python快速入门
如果你写技术文档,试试这个:
# Python快速入门
## 安装Python
### Windows
1. 去python.org下载安装包
2. 双击运行
3. 记得勾选"Add Python to PATH"
### Mac
用Homebrew安装就行:
```bash
brew install python3
验证安装
安装完打开终端,输入:
import sys
print(sys.version)
就能看到你的Python版本了。
💡 提示:建议用Python 3.8以上的版本
第一个程序
print("Hello, World!")
运行一下,你应该能看到输出:
Hello, World!
学习计划
- 完成安装
- 基础语法
- 第一个项目
做完这两个练习,你会发现:哦,原来Markdown真的就这么简单。
---
## 本章小结
恭喜你!你已经学完了Markdown所有的基础语法。我们来总结一下,你可以对着这个清单检查一下,都学会了没有:
✅ **标题和段落**
- 用 `#` 表示标题,一个到六个井号
- 段落之间记得空一行
✅ **文字格式**
- `**粗体**`,`*斜体*`,`~~删除线~~`
✅ **列表**
- `-` 就是无序列表
- `1.` 就是有序列表
- `- [ ]` 就是任务列表
- 嵌套列表前面加空格
✅ **代码**
- `` `行内代码` ``
- ``` 三个反引号做大段代码块,记得写语言名
✅ **表格**
- `|` 分隔列,`-` 分隔表头
- 冒号控制对齐
✅ **引用和分隔线**
- `>` 引用
- `---` 分隔线
就这些。真的没了。
半个小时,差不多就能都学会。学会这些,你写99%的文章都够用了。
现在你会写Markdown了,下一章我们选个趁手的工具,然后就能开始真正写作了。