第二章:基础语法,半小时入门

上一章我们讲明白了为什么要学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. 第三步:关上冰箱门

就这么简单。数字不用管顺序对不对,工具会自动帮你排好,你哪怕全写成 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了,下一章我们选个趁手的工具,然后就能开始真正写作了。
 ​