reStructuredText,重构建文本,是一种优秀的写作工具。
字符串元素
连续的字符组成字符串元素。
行元素
下划线(有时包括上划线)和文本构成的元素,例如标题、表格
块元素
具有相同缩进的元素为块元素,例如段落、表格。块元素以 空行 结束,不管多少空行,都视为一行。
页面元素
类似于行元素,但不多含缩进:
标题
============
分隔线
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
章节标题
=====================
_____________________
~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^
"""""""""""""""""""""
等等
注释
注释是以 .. 起始的超级块元素,注释中的内容只在源文件中显示,并不在结果中显示
.. 注释
第二行
第三行
第二段
第六行
新的开始
引导符 .. 前不能有其它字符,之后要有一个空格与注释内容分隔开( .. 同时是一个字串元素,前后都要有分隔符)
块引用
块引用是以 :: 起始的超级块元素,块引用的内容不作任何处理,以原文显示
块引用 ::
第一行
第二行
第四行
新的开始
引导符 :: 后必须有一个空行