3. reStructuredText 标识语法#
使用shpinx编写文档有如下优点：
sphinx支持rst和markdown语法，方便共享及开源编辑，使用git也方便跟踪。
由于rst语法比markdown语法更强大和方便，更推荐使用 rst 语法编写文档， Linux内核源码文档也是使用rst格式编写的。
关于 Rest 与 Markdown 语法方面的比较，这二者都是标识语言， 没有本质的差别； 从使用及阅读上也很难分出优劣。
现状是 Markdown 得到了更多的支持，工具更多，应用也更广泛。 但是 Rest 在功能需求更多，更复杂方面的优势也毋庸置疑。
这里先介绍 reStructuredText ，其官方文档为 https://docutils.sourceforge.io 。