Markdown语言入门 合集 · 第二章 · 基础语法 · 第 5 篇

推荐阅读时间:约 6 分钟

一个符号,让文章立刻有结构

先说一句可能让你想反驳的话。

一篇文章写不下去,多半不是没东西可写,是没先把标题写好。

多数人写东西的顺序是:打开文件,从第一句话开始往下写。写了两段发现跑题了,想改又舍不得删,于是卡在那里,关掉文件,明天再说。

真正省事的顺序是反过来的。而反过来之后你会发现,它只需要一个符号。

一个符号:#

它的规则只有一条:# 的个数,等于标题的层级。

  • # 是一级标题,一篇文章的总题目
  • ## 是二级标题,文章里的大块
  • ### 是三级标题,大块底下的小节

一直可以写到六级。正常写文章用不到那么细。

它在第 2 篇那张符号对照卡里出现过一次,这次把它讲透。它和别的符号一样,都是在文字前面加个记号——区别是它加在行首:

  • # 我的学习笔记,一级标题,整篇的题目
  • ## 第一章,二级标题,大块分区
  • ### 第一节,三级标题,小节

新手踩的第一个坑:少一个空格

# 后面必须空一格,再写标题文字。

  • 对:# 我的学习笔记
  • 错:#我的学习笔记

少这一格,有些编辑器会直接把它当成普通文字——你敲了什么,它就显示什么。

这个坑几乎人人踩一次,而且踩了很难自己看出来:符号没错,位置没错,就是不生效。所以只记一句:**井号后面空一格,**后面我们会讲为什么必须空一格。

两条不出错的原则

一篇文章只用一个一级标题。

它就是最上面那一个。下面所有分块都用二级、三级往下排。因为一级标题回答的是"这篇写的是什么",它只能有一个,用来做为文章的大标题。

层级不要跳。

如果你在前面二级标题后直接用四级标题,后面又忘了这件事,二级标题后又用了三级标题,这样整篇文章的标题就乱套了,应该按书籍的目录哪样,按层级一层层写,规规整整的!

看一眼差别:同一篇笔记,两种写法

说再多不如看一眼。下面是同一份课后笔记,两个人整理出来的样子。

没有标题的版本:

text
10 行
栈是一种后进先出的结构。
进栈叫 push,出栈叫 pop。
......

队列是先进先出。
进队叫 enqueue,出队叫 dequeue。
......

这两个容易混,考试常考。
......

有标题的版本:

markdown
17 行
## 栈
### 进栈 push
......
### 出栈 pop
......

## 队列
### 进队 enqueue
......
### 出队 dequeue
......

## 容易混的地方
考试常考:
栈是后进先出的结构。
队列是先进先出的结构。
......

内容一个字没变,字也没多打几个。

但第二种,你三个月后想复习"队列"的时候,是直接跳到那一节,还是从头再读一遍?

这就是标题的作用:它不改变内容,只改变你以后能不能快速找到这些内容。

标题的两层价值

第一层给读者:标题是文章的地图。 就像我们读故事书一样很少直接从头读到尾,大多是先扫标题,挑感兴趣的那节翻过去。标题清楚,才找得到路。

第二层给平台:层级标对了,Typora、语雀、飞书这类平台就能自动生成目录,点一下直接跳。目录不用你手写,你只管把层级标对。

换个比方:先装隔板,再往里放书

把写文章想成整理书架。

多数人是先把书摞上去,摞到一半发现没地方了,再想装隔板——只能把书全搬下来重来。

先写标题,等于先装隔板:这层放什么、那层放什么,心里先有数。之后放书就快了,放错了也只是挪一本,不用推翻整排。

所以写文章的顺序是:先写标题,再写内容。 你写不动,往往就是隔板还没装。

5 分钟动手

打开第 4 篇里建好的那个 练习 文件。

不用写正文,只搭骨架,给这篇文章补上三层标题:

markdown
8 行
# 我的练习

## 这周学的
### 标题
### 换行

## 下周要学的
### 列表

敲完看一眼右边,层级的大小差别是不是一眼就看出来了?

(符号记得用英文输入法敲。第 2 篇里给过的那个在线编辑器,打开就能试。)

最后做个总结

# 的个数就是层级,后面空一格,一篇文章只有一个一级标题,层级不跳。先把骨架搭好,内容才好往里放。

下篇预告:第6篇:为什么我按了回车,它却不换段?

下一篇是全系列被问得最多的一个问题。明明按了回车,预览里两句话还是黏在一起——原因只有一个,改起来也只需要一个动作。

「Markdown语言入门」· 第二章 · 第 5 篇 · 完