rst语法简介 =========== 空行分段 ---------- 第一段内容。 第二段和第一段间有空行。 自动续行 ---------- 一个回车不分段, 本行续上行。 不留白续行 ---------- 行尾转义字符让\ 续行之间不留白。 插入换行 ---------- | 保持换行符, | 本行不续行。 段落缩进 ---------- 第一级段落缩进。 第二级段落缩进。 返回一级段落缩进。 代码块 ---------- :: printf("hello, world.\n"); 大段的代码要指明语言类型: (貌似github上必须指明才能高亮) .. code-block:: c #include int main() { printf("hello, world.\n"); return 0; } 无序列表 ---------- * 星号、减号、加号开始列表。 - 列表层级和缩进有关。 + 和具体符号无关。 * 返回一级列表。 有序列表 ---------- 1. 数字和点是一种编号方式。 A. 大写字母编号。 a. 小写字母编号。 2. 继续一级列表。 (I) 大写罗马编号。 i) 小写罗马编号。 列表综合 ---------------------- 1. 列表项可以拆行, 对齐则自动续行。 2. 列表项可包含多个段落。 空行开始新的段落, 新段落要和列表项内容对齐。 3. 列表下的代码段注意对齐即可。 :: print 'hello, world.' 定义 ---------- git Simple and beautiful. hg Another DVCS. subversion VCS with many constrains. Why not Git? 分隔线 ---------- 四条或以上减号、下划线显示为分割线。 ---- 粗体和斜体 ---------- 这是 **粗体** ,这是 *斜体* 。 不留白的\ **粗体**\ 和\ *斜体*\ 效果。 删除线 ---------- .. role:: strike :class: strike :strike:`删除线` 效果 不留白的\ :strike:`删除线`\ 效果 下划线 ---------- .. role:: ul :class: underline :ul:`下划线` 效果 不留白的\ :ul:`下划线`\ 效果 上标和下标 ---------- - Water: H\ :sub:`2`\ O - E = mc\ :sup:`2` 等宽字体 ---------- 两个连续反引号内嵌代码,如:``git status`` 。 引言 ---------- `RTFD` by wind4869 清除标记空白 ------------ 标记符号前后空白\ 用\ **反斜线**\ 消除