*鸭*
鸡的崇拜者
嵌入程序代码
如果需要嵌入大段的程序代码(SQL, 业务逻辑设置, 配置文件等), 在段落末尾添加两个’:’, 并且代码块需要与周围文本以空行分隔,代码的左侧必须缩进, 代码引用到没有缩进的行为止...链接文本是网址,则不需要特别标记,分析器会自动发现文本里的链接或邮件地址。
可以把链接和标签分开, 如下:
段落里包含 `a link`_.
....._a link: http://example.com/
内部链接
章节
章节是文章的主体结构, 分为 标题 章 节 小节 等....定义章节的方式是在行的下面添加 ‘=======’, 比如:
标题
====
章
--
节
~~
小节
####
通常没有专门的符号表示标题的等级,但是对于Python 文档,可以这样认为:
#...及上划线表示部分
* 及上划线表示章节
=, 小章节
-, 子章节
^, 子章节的子章节
", 段落
显示标记
显式标用在那些需做特殊处理的reST结构中, 如尾注,突出段落,评论,通用指令.