SUMMARY.md

mdBook 使用 Summary 文件，来了解要书的章节，应显示的顺序，层次结构以及源文件的位置。没有这个文件，就没有书.

必须叫SUMMARY.md，它是一个 markdown 文件，但格式是非常严格，以便于给 mdbook 解析。我们来看看你应该如何结构化你的SUMMARY.md文件.

结构

Title 一般来说，通常以# Summary。标题开头是常见的做法，但它不是强制性的，解析器只是忽略它。如果你也是这样想，也忽略它。
```
# Summary
```
开头章节 位于主编号章节前，您可以添加一些不编号的开头章节。这对前言，介绍等很有用。但是有一些限制。你不能嵌套开头章节，它们都应该在根级别。一旦添加了编号章节，就无法添加开头章节。

[A Prefix Chapter](relative/path/to/markdown.md)

- [First Chapter](relative/path/to/markdown2.md)

Part Title - 标题，对书进行逻辑分割。它们渲染成不能点击的。它是可选的，然后编号章节可以放在它下面：
```
# My Part Title

- [First Chapter](relative/path/to/markdown.md)
```

编号章节 是本书的主要内容，它们将被编号，并可以嵌套，从而产生一个很好的层次结构(章节，子章节等)

# Title of Part

- [First Chapter](relative/path/to/markdown.md)
- [Second Chapter](relative/path/to/markdown2.md)
- [Sub Chapter](relative/path/to/markdown3.md)

# Title of Another Part

- [Another Chapter](relative/path/to/markdown4.md)

你可以使用-或*表示编号的章节.

结尾章节 位于在编号章节后，您可以添加几个未编号的章节.它们与开头章节相同，但是在编号章节之后，而不是之前.
```
- [Last Chapter](relative/path/to/markdown.md)

[Title of Suffix Chapter](relative/path/to/markdown2.md)
```
Draft chapters - 草稿章节。它的作用就是，给章节的 TODO 字符串。这类章节会被渲染，但是一个禁用的链接。写法如下：
```
- [Draft Chapter]()
```

Separators - Separators 可以在任意其他元素，之前，之间，之后添加。 ---.

# My Part Title

[A Prefix Chapter](relative/path/to/markdown.md)

---

- [First Chapter](relative/path/to/markdown2.md)

Example

下面是指南的 SUMMARY.md，渲染结果正是这本书左边的内容。

# Summary

[介绍](README.zh.md)

# User Guide

- [安装](guide/installation.zh.md)
- [读读读](guide/reading.zh.md)
- [书的制作](guide/creating.zh.md)

# Reference Guide

- [命令行](cli/README.zh.md)
  - [init](cli/init.zh.md)
  - [build](cli/build.zh.md)
  - [watch](cli/watch.zh.md)
  - [serve](cli/serve.zh.md)
  - [test](cli/test.zh.md)
  - [clean](cli/clean.zh.md)
  - [completions](cli/completions.zh.md)
- [规范化](format/README.zh.md)
  - [SUMMARY.md](format/summary.zh.md)
    - [Draft chapter]()
  - [配置](format/configuration/README.zh.md)
    - [通用](format/configuration/general.zh.md)
    - [预处理器](format/configuration/preprocessors.zh.md)
    - [渲染器](format/configuration/renderers.zh.md)
    - [环境变量](format/configuration/environment-variables.zh.md)
  - [主题](format/theme/README.zh.md)
    - [index.hbs](format/theme/index-hbs.zh.md)
    - [Syntax highlighting](format/theme/syntax-highlighting.zh.md)
    - [Editor](format/theme/editor.zh.md)
  - [MathJax 支持](format/mathjax.zh.md)
  - [mdBook 特殊功能](format/mdbook.zh.md)
  - [Markdown](format/markdown.zh.md)
- [集成服务器](continuous-integration.zh.md)
- [For Developers](for_developers/README.zh.md)
  - [预处理器的大小事](for_developers/preprocessors.zh.md)
  - [备用的后端](for_developers/backends.zh.md)

---

[Contributors](misc/contributors.zh.md)

mdBook 中文文档

SUMMARY.md

结构

Example