本章你会学到什么

• 理解 Markdown 的核心价值：用纯文本写出有结构的文档
• 掌握最常用的 Markdown 语法：标题、段落、列表、引用、代码块、链接、图片、表格
• 学会写最基本的 LaTeX 公式
• 建立一个稳定的文档目录结构
• 用 Git 管理文档的修改历史
• 配置 Typora 最影响写作体验的几项设置

这一章的定位

从第一章开始，这本书会系统地讲解 Markdown 的设计思想、Typora 的工作方式、规范差异、图片路径管理，以及长期维护文档的方法。但在那之前，本章先帮你建立"手感"——让你在不理解所有底层细节的情况下，先跑通最常见的写作操作。

Markdown 是什么

Markdown 是一种用纯文本写结构化文档的方式。你用简单的符号（# 表示标题、- 表示列表、> 表示引用）标记文档的结构，然后交给渲染工具（Typora、GitHub、博客系统等）转换成排版好的页面。

Markdown 不是所见即所得的编辑器。你写的是源码，看到的是渲染后的结果。这种"写源码"的方式有一个关键优势：你可以用任何文本编辑器打开、修改、比较和追踪这些文件。也正因为如此，Markdown 文件天然适合用 Git 做版本控制。

Typora 是什么

Typora 是一个 Markdown 编辑器。它的特点是"所见即所得"——你输入 Markdown 符号后，Typora 会立刻渲染成最终效果，而不是让你一直盯着源码。

这并不意味着 Typora 隐藏了 Markdown。恰恰相反，你在 Typora 中写的内容，底层仍然是标准 Markdown 源码。Typora 只是让写作过程更流畅——你不需要在"编辑源码"和"预览效果"之间来回切换。

最常用的 Markdown 语法

日常文档写作最常用的骨架是这八类：标题、段落、列表、引用、代码块、链接、图片、表格。掌握这八类，你已经能写出结构清晰的文档。

标题

# 一级标题
## 二级标题
### 三级标题

# 是文档的主标题，## 是主要部分，### 是部分内的小节。标题的本质是文档的骨架节点，不是用来控制字号的。在 Typora 的"大纲"面板中，标题层级会自动生成文档的导航树——层级越清晰，大纲越有用。

段落

段落之间用一个空行分隔：

这是第一段。

这是第二段。

如果你想在同一段内强制换行（不开始新段落），用 Shift + Enter。

列表

无序列表用 -：

- 苹果
- 香蕉
- 橙子

有序列表用数字加句点：

1. 打开 Typora
2. 新建文档
3. 输入标题
4. 开始写正文

列表可以嵌套，嵌套时用缩进表示层级。缩进不是为了让排版好看，而是表达内容之间的从属关系。

1. 安装环境
   - 安装 Typora
   - 安装 Git
2. 新建仓库
   - 创建 chapters 目录
   - 创建 images 目录

引用

引用块用 > 开头：

> 这是一段引用。

引用块的本质是让正文临时切换到另一种声音——你可以用它放提示、定义、警告、原文摘录或补充说明，和主叙述区分开来。

代码

行内代码用反引号包裹：

使用 `git status` 查看当前状态。

代码块用三个反引号，并标注语言：

```bash
git status
git add .
git commit -m "docs: update chapter"
```

标注语言不是必须的，但它能让渲染工具对代码做语法高亮。常见的语言标签有 bash、python、json、yaml、text。

链接和图片

链接的写法是 [显示文字](URL)：

[Typora 官网](https://typora.io)

图片的写法是 ![替代文字](路径)：

![示意图](../images/example.png)

图片路径用相对路径。图片文件统一放在 images/ 目录下，文件名和章节建立对应关系（比如 chapter-01-figure-01.png），这在长期维护中会省很多麻烦。

表格

| 语法 | 作用 |
| --- | --- |
| # 标题 | 定义标题层级 |
| - 列表 | 表示并列项 |

表格适合做对照和总结，不适合放长段文字。

强调

**粗体**、*斜体*、~~删除线~~

强调是辅助，不是文档的骨架。

LaTeX 公式：先学会最常用的

Typora 原生支持 LaTeX 数学公式。对于新手来说，先掌握以下几种就够用了。

行内公式用单个 $ 包裹，嵌在句子中：

频率可以写成 $f = \frac{1}{T}$。

块级公式用双 $$ 包裹，独占一行：

$$
E = mc^2
$$

常用的公式写法：

写法	效果
\frac{a}{b}	分式 a/b
x^2	上标（平方）
a_1	下标
\sqrt{x}	根号
\sum_{i=1}^{n}	求和
\int_a^b f(x)\,dx	积分

多行对齐公式用 align 环境：

$$
\begin{align}
a+b &= c \\
d &= e+f
\end{align}
$$

文档目录结构

在开始写之前，先建立目录结构。一个适合起步的结构：

my-notes/
├── README.md
├── chapters/
│   └── 01-my-first-note.md
└── images/
    └── 01-example.png

这个结构的核心思想是：内容文件和图片文件分开存放，文件名带编号，方便排序和维护。

Typora 设置

不需要把所有设置研究一遍，但以下几项直接影响写作体验，建议尽早确认。

Markdown 相关：确认行内公式已开启、大纲面板已显示、文件树已启用。

图片相关：建议设置"插入图片时自动复制到指定目录"，并统一使用相对路径。图片文件名采用 chapter-XX-figure-XX.png 的格式。

快捷键：优先掌握创建标题、插入列表、插入代码块、插入表格、搜索、打开大纲这几个操作。不用一次全背，用多了自然就熟了。

用 Git 管理文档

哪怕你是一个人写文档，也值得用 Git。文档会不断修改、删改、回滚和扩写——Git 让每一次修改都有记录，每一次回退都有依据。

最小工作流：

git init
git add .
git commit -m "docs: add initial draft"

如果需要远程备份（比如用 GitHub）：

git remote add origin <your-repo-url>
git push -u origin main

日常循环是 git pull（开工前同步）→ 写作 → git add + git commit（阶段完成后提交）→ git push（收工前推送）。

日常最高频的命令：

命令	作用	什么时候用
git status	查看当前改动状态	随时，养成习惯
git add .	把改动放入暂存区	准备提交前
git commit -m "..."	记录一次变化	完成一个小阶段后
git pull	拉取远程最新内容	开工前
git push	推送本地提交到远程	收工前
git log --oneline	查看简短提交历史	回顾最近做了什么
git diff	查看具体改动内容	提交前检查

更完整的 Git 教程见《Git 与 GitHub》分册。

写作模板

如果你现在就要开始写一篇教程或笔记，可以直接用这个结构：

# 文档标题

## 1. 这篇文档要解决什么问题

用一两段说明目标。

## 2. 需要准备什么

- 工具 A
- 工具 B
- 一个示例文件

## 3. 具体步骤

### 3.1 第一步

写清楚动作。

### 3.2 第二步

继续。

## 4. 常见问题

> 注意：这里放最容易踩坑的地方。

## 5. 小结

总结读者最该记住的内容。

这个模板的价值不在于"好看"，而在于它天然就是一个有结构的文档——标题层级清晰，有目标说明、步骤指引、问题预警和收束总结。

实操练习

建议在继续阅读之前动手做一遍以下练习。

练习 1：写一篇 Markdown 文档

要求包含：1 个一级标题、2 个二级标题、1 个无序列表、1 个有序列表、1 个引用块、1 个代码块、1 个链接。

练习 2：写 3 条公式

一个行内公式、一个块级公式、一个带分式的公式。

练习 3：用 Git 管理

mkdir typora-practice
cd typora-practice
git init

# 写完文档后
git add .
git commit -m "docs: add first practice note"

如果你完成了这三步，Markdown、LaTeX 和 Git 对你来说就不再是纯概念了。

本章小结

Markdown 是用纯文本写结构化文档的方式，Typora 是让这个过程更流畅的编辑器。两者结合，你可以写出结构清晰、易于维护、适合版本控制的文档。

日常写作最常用的语法骨架是八类：标题、段落、列表、引用、代码块、链接、图片、表格。LaTeX 公式先掌握行内公式、块级公式、分式、上下标和根号就够用。

文档开始之前先建好目录结构，图片统一放 images/ 目录并用相对路径引用。用 Git 管理修改历史，养成 status → add → commit → pull / push 的日常循环。

下一步

下一章会回到原点，讨论一个根本性的问题：为什么 Typora 和 Markdown 不只是一套语法工具，而是一种写作方式？理解了这个，后面所有概念都会更自然。