段落
段落是reST文档中最基础的部分,段落通过一个或者多个空行分隔开。左侧必须对齐(没有空格,或者有相同多的空格)。
内联标记
标准的reST内联标记包括:粗体、斜体以及引用。...标记需注意的一些限制:
不能相互嵌套
内容前后不能有空白: 这样写* text* 是错误的,
如果内容需要特殊字符分隔....*鸭*
鸡的崇拜者
嵌入程序代码
如果需要嵌入大段的程序代码(SQL, 业务逻辑设置, 配置文件等), 在段落末尾添加两个’:’, 并且代码块需要与周围文本以空行分隔,代码的左侧必须缩进, 代码引用到没有缩进的行为止...及上划线表示部分
* 及上划线表示章节
=, 小章节
-, 子章节
^, 子章节的子章节
", 段落
显示标记
显式标用在那些需做特殊处理的reST结构中, 如尾注,突出段落,评论,通用指令....开始,后跟空白符,与下面段落的缩进一样. (在显示标记与正常的段落间需有空行,这听起来有些复杂,但是写起来会非常直观.)
指令
指令是显式标记最常用的模块。