.. tags: hello,博客建设 .. description: rst, 语法 .. title: hello-rst .. slug: hello-rst .. link: .. comment: True .. template: post.tmpl .. date: 2013/06/25 23:35:32 rst语法简介 =========== 空行分段 ---------- 第一段内容。 第二段和第一段间有空行。 自动续行 ---------- 一个回车不分段， 本行续上行。 不留白续行 ---------- 行尾转义字符让\ 续行之间不留白。 .. TEASER_END 插入换行 ---------- | 保持换行符， | 本行不续行。 段落缩进 ---------- 第一级段落缩进。 第二级段落缩进。 返回一级段落缩进。 代码块 ---------- :: printf("hello, world.\n"); 大段的代码要指明语言类型： .. code-block:: c :number-lines: #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 清除标记空白 ------------ 标记符号前后空白\ 用\ **反斜线**\ 消除 一般方式表示的表格: ------------------- +------------+------------+-----------+ | Header 1 | Header 2 | Header 3 | +============+============+===========+ | body row 1 | column 2 | column 3 | +------------+------------+-----------+ | body row 2 | Cells may span columns.| +------------+------------+-----------+ | body row 3 | Cells may | - Cells | +------------+ span rows. | - contain | | body row 4 | | - blocks. | +------------+------------+-----------+ 简单方式表示的表格: ------------------- ===== ===== ====== Inputs Output ------------ ------ A B A or B ===== ===== ====== False False False True False True False True True True True True ===== ===== ====== URL自动链接 ----------- - 网址 http://chensy0203.github.com - 邮件 me@foo.bar 文字链接 -------- - 访问 `Google `_ 。 - 上面已定义，直接引用 google_ 链接。 一级标题 ======== 二级标题 -------- 三级标题 ~~~~~~~~ 四级标题 ^^^^^^^^ 五级标题 ++++++++ 六级标题 ```````` 参考 ---- + `rst语法简介 `_ + `常用轻量级标记语言对照 `_