Markdown 教学工作区 · 课程 0001 · 约 20 分钟 · 前置:无 · 2026-09-24

基础块级语法:先搭骨架,再谈好看

为什么是这一步

使命里说:这个库的每一篇笔记、每个 README、以及将来给 Zephyr 提的文档 PR,都靠 Markdown 写出来。 而"写得对不对"在这个库里有客观标准 —— 本库 141 篇 md,markdownlint 当前 0 条告警。 所以这节课的验收不是"我觉得挺好看",而是lint 不报错。

最小知识:三条,够用就行

1. 块级 vs 行内。块级元素(标题、列表、引用、代码块、表格)独占一行或成段; 行内元素(加粗、斜体、行内代码)嵌在句子里。这节课只碰块级 —— 骨架搭对了,行内是锦上添花。
2. 标题就是文档骨架。一篇只有一个一级标题(H1);层级不跳级(H2 下面直接 H4 会被 lint 抓); 同级标题不重名(本库把这条放宽成"兄弟标题不重名")。
3. 列表三种写法,各有各的语义。- 无序、1. 有序(数字会自动重排,写全 1. 也行)、 - [ ] 任务列表(本库大量使用:项目说明里的待办就是它)。

动手:写一篇能过 lint 的骨架

在本项目目录下新建文件:

10-项目/2026-10-掌握Markdown/练习-块级语法.md

把下面这段当模板,填成你自己的内容(注意每处空行):

---
type: note
tags: [markdown, 练习]
status: learning
date: 2026-09-24
related: "[[Markdown语法]]"
---

# 块级语法练习

## 我这次要练的三件事

- 标题层级不跳级
- 列表前后留空行
- 任务列表当待办用

## 顺序也要练

1. 先写骨架
2. 再填内容
3. 最后跑 lint

## 本周待办

- [ ] 把这篇笔记写完整
- [ ] 让它 lint 通过
- [x] 打开这节课

## 一个引用块

> 引用块用 > 开头,可以连写多行。
> 第二行仍然是同一个引用。

然后故意犯两个错,看 lint 抓不抓得到(这就是反馈环):

1. 删掉 ## 我这次要练的三件事 与上面标题之间的空行 → 应报 MD022(标题前后要空行)
2. 把 - 标题层级不跳级 改成 #### 标题层级不跳级 → 应报 MD001(标题层级只能逐级递增)

看到黄线之后把两处改回来 —— 你会比"背规则"记得牢得多。

自测(选项一样长,别从长度上猜)