3.2. ReST 行内文本常用语法#

3.2.1. 行内文本的一般语法#

文本的一般表示语法:

**强调**

*斜体*

``monospace,会变色,具体作用不清楚``

3.2.2. 内联标记 Inline Markup#

语法

效果

说明

*emphasis*

emphasis

强调,斜体

**strong**

strong

加粗

`interpreted-text`

interpreted-text

使用两个反逗号包裹内容,表征对其解释

``inline literal``

inline literal

当包括内容包含空格时使用两个反逗号来包裹

ref_  .. _ref: 链接

ref

链接:纯文本,外部链接

`phrase ref`_

带空格 外链

链接:文字间有空格标点,外部链接

anonymous__

anonymous

链接: 匿名链接

_`inline_link

inline_link

交叉引用链接

|substitution ref|

|substitution ref|

指示链接(图片,链接等)

footnote [1]_

footnote [1]

脚注(包括参考文献)

citation [CIT2002]_

citation [CIT2002]

引用

http://docutils.sf.net/

http://docutils.sf.net/

独立链接

3.2.3. 反斜杠转义 Escaping with Backslashes#

使用反斜杠来转义任意rst语法符号为符号本身,包括反斜杠自己

  • 转义内联标记: \*去除斜体*

  • 转义反斜杠(用两个反斜杠): \\

在python中,最简单的方式是在字符串外表示raw strings(加r)

py字符串

显示结果

r"""*去除斜体* "\""""

r"""*去除斜体* "\""""

"""\*去除斜体* "\\\""""

"""*去除斜体* "\""""

"""*去除斜体* "\""""

"""*去除斜体* "\""""