标记需注意的一些限制:
不能相互嵌套
内容前后不能有空白: 这样写* text* 是错误的,
如果内容需要特殊字符分隔....使用反斜杠转义,如: this is\ *one*\ word
这些限制在未来版本可能会被改善.
列表与引用
顺序列表
1. 第 **一** 条
段落
#. 第二条
1....*鸭*
鸡的崇拜者
嵌入程序代码
如果需要嵌入大段的程序代码(SQL, 业务逻辑设置, 配置文件等), 在段落末尾添加两个’:’, 并且代码块需要与周围文本以空行分隔,代码的左侧必须缩进, 代码引用到没有缩进的行为止...可以把链接和标签分开, 如下:
段落里包含 `a link`_.
.....及上划线表示部分
* 及上划线表示章节
=, 小章节
-, 子章节
^, 子章节的子章节
", 段落
显示标记
显式标用在那些需做特殊处理的reST结构中, 如尾注,突出段落,评论,通用指令.