第1章 打开编辑器写第一篇

第1章 打开编辑器写第一篇

章节摘要：这一章把 Markdown 的全部基础语法走一遍——标题、段落、强调、转义、列表、引用、代码、链接与图片。每节都从一段可以立刻敲进编辑器的源码开始，你看到的不是定义，而是"我写了这几个字符，屏幕上发生了什么"。读完本章，你能独立写出一篇结构完整、重点突出、带图带码的技术笔记。

学习目标

阅读完本章，你应当能够：

1. 用井号搭出最多六级的标题层级，并知道实际写作该止步于第几级。
2. 分清"空行分段"与"行尾两空格换行"的差别，不再疑惑为什么两行被并成一行。
3. 用星号、下划线写出粗体、斜体、粗斜体，并理解为什么推荐只用星号。
4. 写出嵌套有序/无序列表，包括最容易踩的缩进坑。
5. 用引用块组织引文，用围栏代码块展示任意语言的代码。
6. 写链接与图片，掌握行内式与引用式两种写法的取舍。

核心概念速览

骨架先行，血肉后补：先定标题层级，再填段落与行内记号，是写 Markdown 最省事的顺序。

子章节导航

1.1 标题与段落：先搭骨架

敲下第一个井号，理解标题分级与空行分段的底层规则。

1.2 强调与转义：让重点跳出来

粗体、斜体的四种写法，以及特殊字符"不听话"时的转义手段。

1.3 列表：三种清单的取舍

无序、有序、嵌套，加上那个经典的"缩进差一格"排错案例。

1.4 引用块：把别人的话放进框里

大于号的叠加、嵌套与退出条件。

1.5 代码块与语法高亮

行内代码与围栏代码块，高亮语言名的写法与反引号自身的转义。

1.6 链接与图片

行内式与引用式、标题参数，以及图片与链接只差一个感叹号这件事。

子章节之间的逻辑关系

六节是"骨架 → 行内 → 块级 → 外部内容"的递进关系：

1.1 骨架（标题/段落）
      │
      ├── 1.2 行内记号（强调/转义）── 装饰骨架上的文字
      ├── 1.3 块级结构（列表）      ── 组织多条并列信息
      ├── 1.4 块级结构（引用）      ── 引入他人内容
      └── 1.5 + 1.6 代码与媒体     ── 引入机器内容与外部资源
​

前三节解决"文字怎么摆"，后三节解决"文字之外的东西怎么进来"。

这个顺序也解释了本章各节练习的设计逻辑：1.1 练的是"先想结构再落笔"，1.2、1.3 练的是"控制一行与一组信息的粒度"，1.4 到 1.6 练的是"把不属于正文的内容正确地挂进来"。六节练完，你手里的工具已经覆盖日常笔记九成以上的写作场景，第 2 章之后的进阶记号都是在这些地基上的延伸，而不是新的地基。

前置知识与后续延伸

• 前置：会打字、会用任意文本编辑器即可，零门槛。
• 为后续铺垫：第 2 章的表格、任务列表建立在列表与块级概念上；第 3 章的图表本质上是特殊围栏代码块；第 6 章的排错大量依赖本章的"空行/缩进"规则。

上机练习：把一章语法压进一篇笔记

本章最有效的收尾不是读完，而是写完。给你一个具体的练习任务：选一件你本周真实做过的事（一次环境配置、一次问题排查、一次会议），用本章全部六组语法各至少一次写成一篇笔记——标题定层级、列表列步骤、引用块放原始报错或他人结论、代码块贴命令与输出、链接挂官方文档、一张架构或流程示意。写完后做两步自检：第一，只看标题清单能否还原笔记逻辑（1.1 的自检法）；第二，把笔记发给一位同事，让他不复述地执行其中的步骤——他卡住的地方，就是你表达里缺的那块语法或纪律。这篇笔记值得保留：第 6 章讲团队规范时，它会成为你对照"十二条军规"的第一份真实样本。