1. rst basic start 基础语法

具体基础语法请参考官方文档 [Ref-offical-page]

此处只使用在日常文章写作中最常使用的一些内容。

1.1 标题

一级标题在文本的第二行使用 # 来标记,就像手打下划线一样。

二、三、四、五、六级标题分别使用 * + = : -。

标题递进必须按顺序,不能一级标题后紧跟三级标题,否则会渲染失败。

原则上这个手打的“下划线”的长度至少跟标题文字一样长,可以超长。

注解

通常记住 # * + 这三级就足够使用了,使用同级别的标题行会被目录侧边栏收录在一个层级中。

References

Ref-offical-page

https://www.sphinx-doc.org/zh_CN/master/usage/restructuredtext/basics.html