对标记语言的一个非常全的总结-程序员宅基地

突然发现：

这本书应该也不错：

http://www.worldhello.net/gotgithub/index.html

7. 附录：轻量级标记语言

没有标记语言就没有Web和丰富多彩的互联网，但创造了Web的HTML语言并非尽善尽美，存在诸如难读、难写、难以向其他格式转换的问题。究其根源是因为HTML语言是一种“重”标记语言，对机器友好而并非对人友好。

下面这段HTML源码，非技术控阅读起来会遇到困难。

<html>
<head>
  <meta content='application/xhtml+xml;charset=utf-8' http-equiv='Content-type' />
  <title>轻量级标记语言</title>
</head>
<body>
  <h1 id='id1'>轻量级标记语言</h1>

  <p><strong>轻量级标记语言</strong> 是一种 <em>语法简单</em> 的标记语言。
  它使用易于理解的格式标记，没有古怪的 <code>&lt;标签&gt;</code> 。</p>

  <ul>
  <li>可以使用最简单的文本编辑器编辑。</li>
  <li>所见即所得，非技术控亦可直接阅读源码。</li>
  <li>可版本控制。</li>
  <li>实现单一源文件出版。</li>
  </ul>
<body>
</html>

同样的信息如果换用轻量级标记语言来表达，就非常直观了。如下所示：

轻量级标记语言
==============

**轻量级标记语言** 是一种 *语法简单* 的标记语言。
它使用易于理解的格式标记，没有古怪的 `<标签>` 。

- 可以使用最简单的文本编辑器编辑。
- 所见即所得，非技术控亦可直接阅读源码。
- 可版本控制。
- 实现单一源文件出版。

GitHub另人着迷的一个因素就在于GitHub为用户提供更为便捷地创建UGC（用户生成内容）的方法，其奥秘就在于使用了轻量级标记语言。无论是代码提交说明、提交评注、问题描述、项目的README文件、维基页面、用户主页和项目主页都可以使用Markdown[8]等轻量级标记语言来撰写。轻量级标记语言如Markdown是对人友好的标记语言，一些语法参照了我们写电子邮件时的习惯，即使第一次接触用轻量级标记语言撰写的文件，也可以毫无障碍地理解其中的内容。

虽然GitHub更倾向于使用Markdown标记语言[9]，但很多地方也提供对其他轻量级标记语言的支持。包括为Python程序员所熟悉的reStructedText[10]，为Ruby程序员所熟悉的Textile[11]、RDoc[12]，为Perl程序员所熟悉的POD[13]，为Emacs用户所熟悉的Org-mode[14]，为维基用户所熟悉的MediaWiki[15]和Creole[16]，以及可作为DocBook[17]前端的颇有前途的AsciiDoc[18]标记语言。

下面通过一张表格对几种常用的轻量级标记语言加以对照，供有不同标记语言偏好的用户参考，便于在GitHub某些不能随意更换标记语言而只能使用GFM（GitHub风格的Markdown）的场合可以自如地转换。

在“表7-1：常用轻量级标记语言对照”中，为使表格更加紧凑使用代号表示各种标记语言。例如：md为Markdown，gfm是GitHub风格的Markdown，rst为reStructedText，ttl为Textile，asc为AsciiDoc，org为Org-mode。

类别标记语言代码示例输出示例

MD RST TTL ASC ORG

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

输出略。

注解

Atx风格标题后面可接匹配的井号。

rst

一级标题
========

二级标题
--------

三级标题
^^^^^^^^

输出略。

注解

reST标题可用下列符号标记： # * = - ^ ~ ` : . _ + ” 等。

ttl

h1. 一级标题
h2. 二级标题
h3. 三级标题
h4. 四级标题
h5. 五级标题
h6. 六级标题

输出略。

asc

AsciiDoc 提供两种风格的标题。

文档标题
========

一级标题
--------

二级标题
~~~~~~~~

三级标题
^^^^^^^^

四级标题
++++++++

或者使用下面单行标题风格进行定义。

= 文档标题 =
== 一级标题 ==
=== 二级标题 ===
==== 三级标题 ====
===== 四级标题 =====

输出略。

注解

除了两种不同风格的标题外，还支持以点开始的块标题，块标题不生成目录。如：

.BlockTitle

org

* 一级标题
** 二级标题
*** 三级标题

输出略。

注解

为支持更多标题级别需要设置 #+OPTIONS:H:6。

段落

空行分段

rst

ttl*

asc

org

一个回车不分段，
本行续上行。

空行开始新段落。

一个回车不分段，°本行续上行。

空行开始新段落。

无空白续行

rst

行尾转义字符让\
续行之间无空格。

行尾转义字符让续行之间无空格。

插入换行

行尾两空格°°
保持换行。

行尾两空格

保持换行。

gfm

ttl

GFM、Textile等
保持段落内换行符。

GFM、Textile等

保持段落内换行符。

rst

| 保持换行符，
| 本行不续行。

保持换行符，

本行不续行。

rst

.. role:: raw-html(raw)
   :format: html

用新定义的role插入换行，
:raw-html:`<br />`
本行不再续行。

用新定义的role插入换行，
本行不再续行。

asc

行尾的空格和加号 +
保持换行。

行尾的空格和加号

保持换行。

org*

行尾两个反斜线\\
保持段落内换行符。

行尾两个反斜线

保持段落内换行符。

org

#+BEGIN_VERSE
 保持换行符，
 本行不续行。
#+END_VERSE

保持换行符，

本行不续行。

段落缩进

rst

邮件体段落缩进：

> 第一级段落缩进。
>
> > 第二级段落缩进。
>
> 返回一级段落缩进。

邮件体段落缩进：

第一级段落缩进。

第二级段落缩进。

返回一级段落缩进。

rst

Python式段落缩进：

  第一级段落缩进。

    第二级段落缩进。

  返回一级段落缩进。

Python式段落缩进：

第一级段落缩进。

第二级段落缩进。

返回一级段落缩进。

ttl

Textile式段落缩进：

bq. 本段缩进。

正常段落。

bq.. 注意缩进关键字后有两个点。

后续段落持续缩进，
直至遇到 p. 定义的段落。

p. 正常段落不再缩进。

Textile式段落缩进：

本段缩进。

正常段落。

注意缩进关键字后有两个点。

后续段落持续缩进，

直至遇到 p. 定义的段落。

正常段落不再缩进。

asc

四个或以上的下划线括起的区域为引言缩进。

[quote, author, source]
______________________________
引言...
______________________________

四个或以上的下划线括起的区域为引言缩进。

引言...

source

—— author

org

Org-mode式段落缩进：

#+BEGIN_QUOTE
 段落缩进。
#+END_QUOTE

Org-mode式段落缩进：

段落缩进。

代码块

四个空格缩进是代码块：

    $ printf "Hello, world.\n"

四个空格缩进是代码块：

$ printf "Hello, world.\n"

gfm

三个连续的`或~等符号界定代码块。

```ruby
require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html
```

三个连续的`或~等符号界定代码块。

require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html

rst

双冒号后缩进为代码块。

::

  $ printf "Hello, world.\n"

还可声明语言类型实现语法加量。

.. code-block:: sh

   $ printf "Hello, world.\n"

双冒号后缩进为代码块。

$ printf "Hello, world.\n"

还可声明语言类型实现语法加量。

$ printf "Hello, world.\n"

ttl

以bc.或bc..指令开头的是代码块。

bc.. $ git init

$ git commit --allow-empty

p. 本段不再是代码块。

以bc.或bc..指令开头的是代码块。

$ git init

$ git commit --allow-empty

本段不再是代码块。

ttl

原样格式输出，相当于<PRE>标签。

pre..
           更上一层楼
欲穷千里目

p. 恢复正常段落。

原样格式输出，相当于<PRE>标签。

           更上一层楼
欲穷千里目

恢复正常段落。

asc

四个或更多减号括起代码块，
还可声明语言种类。

[source, c]
-----------------------------
#include <stdio.h>

int main() {
   printf("Hello World!\n");
   exit(0);
}
-----------------------------

四个或更多减号括起代码块，还可声明语言种类。

#include <stdio.h>

int main() {
         
   printf("Hello World!\n");
   exit(0);
}

asc

正常段落。

  缩进段落相当于添加<pre>标签，
  等宽字体，原样输出。

缩进会和其他语法如列表相混淆，
可用 `[literal]` 显示声明。

[literal]
原样输出，
显示为等宽字体。

或用四个以上点组成的定界符标记。

..............................
原样输出，
显示为等宽字体。
..............................

正常段落。

缩进段落相当于添加<pre>标签，
等宽字体，原样输出。

缩进会和其他语法如列表相混淆，可用[literal] 显示声明。

原样输出，
显示为等宽字体。

或用四个以上点组成的定界符标记。

原样输出，
显示为等宽字体。

org

下面是代码块。

#+BEGIN_SRC ruby
  require 'redcarpet'
  md = Redcarpet.new("Hello, world.")
  puts md.to_html
#+END_SRC

下面是代码块。

require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html

列表

无序列表

rst

* 星号、减号、加号开始列表。

  - 列表层级和缩进有关。

    + 和具体符号无关。

* 返回一级列表。

星号、减号、加号开始列表。
- 列表层级和缩进有关。
  - 和具体符号无关。
返回一级列表。

ttl

* 星号开始无序列表。
** 更多星号代表不同层级。
*** 三级列表。
* 返回一级列表。

星号开始无序列表。
- 更多星号代表不同层级。
  - 三级列表。
返回一级列表。

asc

- 1个减号开始列表。
* 或1到5个星号开始列表。
** 三级列表。
- 返回一级列表。

1个减号开始列表。
- 或1到5个星号开始列表。
  - 三级列表。
返回一级列表。

org

列表语法和Markdown、reST类似。
星号和列表语法冲突需缩进，不建议使用。

  - 减号、加号开始列表。

    + 列表层级和缩进有关。

      - 和具体符号无关。

  - 返回一级列表。

列表语法和Markdown、reST类似。星号和列表语法冲突需缩进，不建议使用。

减号、加号开始列表。
- 列表层级和缩进有关。
  - 和具体符号无关。
返回一级列表。

有序列表

数字和点开始有序列表。

注意子列表的缩进位置。

三级列表。
编号会自动更正。

二级列表，编号自动更正为2。

返回一级列表。

数字和点开始有序列表。
1. 注意子列表的缩进位置。
  1. 三级列表。
  2. 编号会自动更正。
2. 二级列表，编号自动更正为2。
返回一级列表。

rst

1. 数字和点是一种编号方式。

   A. 大写字母编号。

      a. 小写字母编号。

2. 继续一级列表。

   (I) 大写罗马编号。

       i) 小写罗马编号。

数字和点是一种编号方式。
1. 大写字母编号。
  1. 小写字母编号。
继续一级列表。
1. 大写罗马编号。
  1. 小写罗马编号。

ttl

# 井号开始有序列表。
# 有序列表自动编号。
## 更多井号代表不同层级。
### 三级列表。
# 返回一级列表。

井号开始有序列表。
有序列表自动编号。
1. 更多井号代表不同层级。
  1. 三级列表。
返回一级列表。

asc

1. 和reST一样支持多种编号方式。
a. 层级靠列表风格决定，而非缩进。
A. 三级列表。
b. 返回二级列表。
i) 罗马数字列表。
IX)  大写罗马。编号自动纠正。
2. 返回一级列表。

注解

还可以用1到5个点开始有序列表，自动按数字、字母方式编号。如：

. 数字一级列表。
.. 字母二级列表。
... 罗马数字三级列表。
.... 大写字母四级列表。
..... 大写罗马五级列表。

和reST一样支持多种编号方式。
1. 层级靠列表风格决定，而非缩进。
  1. 三级列表。
2. 返回二级列表。
  1. 罗马数字列表。
    1. 大写罗马。编号自动纠正。
返回一级列表。

org

1. 数字和点或右括号开始有序列表。

   1) 缩进即为子列表。

      1. 三级列表。
      1. 编号会自动更正。

   2) 二级列表。

2. 返回一级列表。

数字和点或右括号开始有序列表。
1. 缩进即为子列表。
  1. 三级列表。
  2. 编号会自动更正。
2. 二级列表。
返回一级列表。

列表续行、段落和代码块

1. 列表项可以折行，
   对齐则自动续行。

2. 列表项可包含多个段落。

    空行开始的新段落必须缩进四个空格，
    段落才属于列表项。

3. 列表中的代码块要缩进8个空格。

        $ printf "Hello, world.\n"

列表项可以折行，对齐则自动续行。
列表项可包含多个段落。

空行开始的新段落必须缩进四个空格，段落才属于列表项。
列表中的代码块要缩进8个空格。
```
$ printf "Hello, world.\n"
```

rst

1. 列表项可以折行，
   对齐则自动续行。

2. 列表项可包含多个段落。

   空行开始的新段落，
   新段落要和列表项内容对齐。

3. 列表下的代码段注意对齐即可。

   ::

     $ printf "Hello, world.\n"

列表项可以折行，对齐则自动续行。
列表项可包含多个段落。

空行开始的新段落，新段落要和列表项内容对齐。
列表下的代码段注意对齐即可。
```
$ printf "Hello, world.\n"
```

asc

1. 列表项可以折行，
   对齐则自动续行。

2. 列表项可包含多个段落。
+
加号代表本段落属于列表。
+
--
两个减号包裹的块作为一整体
属于列表。

其中分段无需再使用加号。
--

3. 注意列表项内代码段前空行用加号替换。
+
--------
$ printf "Hello, world.\n"
--------

列表项可以折行，对齐则自动续行。
列表项可包含多个段落。

加号代表本段落属于列表。

两个减号包裹的块作为一整体属于列表。

其中分段无需再使用加号。
注意列表项内代码段前空行用加号替换。
```
$ printf "Hello, world.\n"
```

org

1. 列表项可以折行，
   对齐则自动续行。

2. 列表项可包含多个段落。

   空行开始的新段落，
   新段落要和列表项内容对齐。

3. 列表下的代码段注意对齐即可。

   #+BEGIN_SRC bash
     $ printf "Hello, world.\n"
   #+END_SRC

列表项可以折行，对齐则自动续行。
列表项可包含多个段落。

空行开始的新段落，新段落要和列表项内容对齐。
列表下的代码段注意对齐即可。
```
$ printf "Hello, world.\n"
```

定义

rst

git
  Simple and beautiful.

hg
  Another DVCS.

subversion
  VCS with many constrains.

  Why not Git?

git

Simple and beautiful.

Another DVCS.

subversion

VCS with many constrains.

Why not Git?

ttl

- git := Simple and beautiful.
- hg := Another DVCS.
- subversion :=
VCS with many constrains.

Why not Git? =:

git

Simple and beautiful.

Another DVCS.

subversion

VCS with many constrains.

Why not Git?

asc

git ::
    Simple and beautiful.
hg :: Another DVCS.
subversion :: VCS with many constrains.
              +
              Why not Git?

git

Simple and beautiful.

Another DVCS.

subversion

VCS with many constrains.

Why not Git?

org

- git :: Simple and beautiful.
- hg :: Another DVCS.
- subversion :: VCS with many constrains.

                Why not Git?

git

Simple and beautiful.

Another DVCS.

subversion

VCS with many constrains.

Why not Git?

分隔线

ttl

三条短线或以上显示为分隔线。

---

输出略。

rst

四条短线或以上显示为分隔线。

----

输出略。

asc

三个或更多的单引号作为分割线。

'''

输出略。

org

五条短线或以上显示为分隔线。

-----

输出略。

字体

粗体和斜体

这些都是 **粗体** 或 __粗体__ ，
这写都是 *斜体* 或 _斜体_ 。

这些都是粗体或粗体，这些都是斜体或斜体。

rst

这是 **粗体** ，这是 *斜体* 。

不留白的\ **粗体**\ 和\ *斜体*\ 效果。

这是粗体，这是斜体。

不留白的粗体和斜体效果。

ttl

这些都是 *粗体* 或 **粗体** ，
这些都是 _斜体_ 或 __斜体__ 。

这些都是粗体或粗体，这些都是斜体或斜体。

asc

这是 *粗体* ，
这是 _斜体_ 或 '斜体' 。

不留白的**粗体**和__斜体__效果。

这是粗体，这是斜体或斜体。

不留白的粗体和斜体效果。

org

这是 *粗体* ，这是 /斜体/ 。

这是粗体，这是斜体。

删除线

gfm

~~删除线~~ 效果

删除线效果

rst

.. role:: strike
   :class: strike

:strike:`删除线` 效果

不留白的\ :strike:`删除线`\ 效果

删除线效果

不留白的删除线效果

ttl

-删除线- 效果

删除线效果

asc

[line-through]#删除线# 效果

不留白的[line-through]##删除线##效果

删除线效果

不留白的删除线效果

org

+删除线+ 效果

删除线效果

下划线

<u>下划线</u> 效果

下划线效果

rst

.. role:: ul
   :class: underline

:ul:`下划线` 效果

不留白的\ :ul:`下划线`\ 效果

下划线效果

不留白的下划线效果

ttl

+下划线+ 效果

下划线效果

asc

[underline]#下划线# 效果

不留白的[underline]##下划线##效果

下划线效果

不留白的下划线效果

org

_下划线_ 效果

下划线效果

上标、下标

* Water: H<sub>2</sub>O
* E = mc<sup>2</sup>

Water: H₂O
E = mc²

注解

通过直接嵌入HTML代码实现。

rst

* Water: H\ :sub:`2`\ O
* E = mc\ :sup:`2`

Water: H₂O
E = mc²

ttl

* Water: H ~2~ O
* E = mc ^2^

Water: H ₂ O
E = mc ²

asc

* Water: H~2~O
* E = mc^2^

Water: H₂O
E = mc²

org

* Water: H_2 O
* E = mc^2

Water: H₂ O
E = mc²

等宽字体

asc

行内反引号嵌入代码，如: `git status` 。

行内反引号嵌入代码，如: git status 。

rst

两个连续反引号嵌入代码，如: ``git status`` 。

两个连续反引号嵌入代码，如: git status。

注解

相当于 :literal:`git status` 。只用一个反引号则相当于 :title-reference:`引言` 。

ttl

行内用字符@嵌入代码，如: @git status@ 。

行内用字符@嵌入代码，如: git status 。

asc

行内用字符+标识等宽字体，如: +git status+ 。

行内用字符+标识等宽字，如: git status。

org

行内用字符=或~嵌入代码，如:
=git status= 和 ~git st~ 。

行内用字符=或~嵌入代码，如: git status和 git st 。

引言

rst

`Got GitHub` by Jiang Xin.

Got GitHub by Jiang Xin.

ttl

??Got GitHub?? by Jiang Xin.

Got GitHub by Jiang Xin.

清除标记空白

rst

标记符号前后空白\
用\ **反斜线**\ 消除

标记符号前后空白用反斜线消除

链接

URL自动链接

gfm

rst

asc

org

* 网址 http://github.com/
* 邮件 [email protected]

网址 http://github.com/
邮件 [email protected]

文字链接

* 访问 [Google](http://google.com "Search")
* 访问 [GitHub][1]
* 访问 [WorldHello][]

 [1]: http://github.com "Git host"
 [worldhello]: http://www.worldhello.net

访问 Google
访问 GitHub
访问 WorldHello

rst

* 访问 `Google <http://google.com/>`_ 。
* 上面已定义，直接引用 google_ 链接。
* 链接地址在后面定义，如： GitHub_ 。
* 反引号括起多个单词的链接。如 `my blog`_ 。

.. _GitHub: http://github.com
.. _my blog: http://www.worldhello.net

访问 Google。
上面已定义，直接引用 google 链接。
链接地址在后面定义，如： GitHub。
反引号括起多个单词的链接。如 my blog。

ttl

* 访问 "Google (Search)":https://google.com
* 访问 "GitHub (Git host)":github
* 访问 "WorldHello":wh

[github]http://github.com
[wh]http://www.worldhello.net

访问 Google
访问 GitHub
访问 WorldHello

asc

* 访问 http://google.com[Google]
* 访问 link:/index.html[首页]

访问 Google
访问首页

org

* 访问 [[http://google.com][Google]]

访问 Google

内部跳转

<a name="md-anchor" id="md-anchor"></a>

跳转至 [文内链接](#md-anchor) 。

跳转至文内链接。

rst

.. _fig1:

.. figure:: /images/github.png

   内部跳转图例

上面定义的位置，可以：

* 通过 fig1_ 跳转。
* 或者 `点击这里 <#fig1>`__ 跳转。
* 或者参见 :ref:`fig1`\ 。

内部跳转图例

上面定义的位置，可以：

通过 fig1 跳转。
或者点击这里跳转。
或者参见 内部跳转图例。

ttl

<a name="ttl-anchor" id="ttl-anchor"></a>

跳转至 "文内链接":#ttl-anchor 。

跳转至文内链接。

asc

两种方式在这儿定义内部链接。

[[alink1,链接标题1]]
anchor:alink2[链接标题2]

指向位置：

- 跳转至 <<alink1,内部链接1>>
- 跳转至 xref:alink2[]

两种方式在这儿定义内部链接。

指向位置：

跳转至内部链接1
跳转至链接标题2

org

# <<org-anchor>>

跳转至 [[#org-anchor][文内链接]]

跳转至文内链接。

GitHub提交和问题链接

gfm

* SHA: cea00609ca8441c82bc9760ae5eea...
* User@SHA ref: mojombo@cea00609ca84...
* User/Project@SHA:
  mojombo/god@cea00609ca8441c82bc976...
* \#Num: #1
* User/#Num: mojombo#1
* User/Project#Num: mojombo/god#1

SHA: cea00609ca8441c82bc...
User@SHA ref: mojombo@cea00609ca8...
User/Project@SHA: mojombo/god@cea0060... [19]
#Num: #1
User/#Num: mojombo#1
User/Project#Num: mojombo/god#1 [20]

脚注

rst

reST脚注的多种表示法：

* 脚注即可以手动分配数字 [1]_ ，
  也可以使用井号自动分配 [#]_ 。

* 自动分配脚注 [#label]_ 也可以用
  添加标签形式 [#label]_ 多次引用。

* 还支持用星号嵌入符号式脚注，
  如这个 [*]_ 和 这个 [*]_ 。

* 使用单词做标识亦可 [CIT2012]_ 。


.. [1] 数字编号脚注。
.. [#] 井号自动编号。
.. [#label] 井号添加标签以便多次引用。
.. [*] 星号自动用符号做脚注标记。
.. [*] 星号自动用符号做脚注标记。
.. [CIT2012] 单词或其他规定格式。

reST脚注的多种表示法：

脚注即可以手动分配数字[1]，也可以使用井号自动分配[2]。
自动分配脚注[3]也可以用添加标签形式[3]多次引用。
还支持用星号嵌入符号式脚注，如这个[*]和这个[†]。
使用单词做标识亦可[CIT2012]。

[1]

数字编号脚注。

[2]

井号自动编号。

[3]	(1, 2) 井号添加标签以便多次引用。

[*]	星号自动用符号做脚注标记。

[†]	星号自动用符号做脚注标记。

[CIT2012]

单词或其他规定格式。

ttl

Textile是Redmine [4] 内置的标记语言。

fn4. http://goo.gl/rGyvs

Textile是Redmine [4] 内置的标记语言。

[4]	http://goo.gl/rGyvs

asc

- 内联方式 footnote:[此处定义] 定义的脚注。
- 定义脚注时可用一个ID标记
  footnoteref:[note6, 可多次引用] 。
- 引用已定义的脚注 footnoteref:[note6] 。

内联方式 [5] 定义的脚注。
定义脚注时可用一个ID标记 [6] 。
引用已定义的脚注 [6] 。

[5]

此处定义

[6]	(1, 2) 可多次引用

org

Twitter widget in Org homepage[fn:org]
cannot be accessed in Mainland China, which
caused the homepage load very slowly. >:[

[fn:org] The link is: http://orgmode.org

Twitter widget in Org homepage [7]cannot be accessed in Mainland China, which caused the homepage load very slowly. >:[

[7]	The link is: http://orgmode.org

图片

![GitHub](/images/github.png "Logo")

GitHub Logo: ![GitHub][logo]

[logo]: /images/github.png "Logo"

GitHub Logo: logo

rst

.. figure:: /images/github.png
   :width: 32

   图：GitHub Octocat

* GitHub Logo: |octocat|
* 带链接的图片：
  |imglink|_
* 下图向右浮动。
   .. image:: /images/github.png
      :align: right

.. |octocat| image:: /images/github.png
.. |imglink| image:: /images/github.png
.. _imglink: https://github.com/

图：GitHub Octocat

GitHub Logo:
带链接的图片：
下图向右浮动。

ttl

* GitHub Logo: !/images/github.png(Logo)!
* 带链接的图片：
  !/images/github.png!:https://github.com/
* 下图向右浮动。
  !>/images/github.png!

GitHub Logo:
带链接的图片：
下图向右浮动。

asc

.GitHub Octocat
image::/images/github.png["Logo",width=32]

- GitHub Logo:
  image:/images/github.png["Logo"]

图：GitHub Octocat

GitHub Logo:

org

* GitHub Logo: [[file:/images/github.png]]
* 带链接的图片：
  [[https://github.com/][file:/images/...]]

GitHub Logo:
带链接的图片：

表格

gfm

head1 | head2  | head2
------|:------:|------:
left  | center | right
left  | center | right

head1	head2	head3
left	center	right
left	center	right

rst

.. table:: 示例表格
   :class: classic

   +---------+--------+--------+
   | head1   | head2  | head3  |
   +=========+========+========+
   |         | cell   | cell   |
   | rowspan +--------+--------+
   |         | * colspan       |
   |         | * another line  |
   +---------+-----------------+

示例表格
head1	head2	head3
rowspan	cell	cell
rowspan	colspan another line

ttl

|_. head1 |_. head2 |_. head3 |
|/3. rowspan | cell  | cell |
|\2. colspan |
| cell | cell |

示例表格
head1	head2	head3
rowspan	cell	cell
	colspan
	cell \| cell

asc

[width="50%"]
|============================
|1 |2 |3 |4
|5 2.2+|6 .3+|7
|8
|9 2+|10
|============================

1	2	3	4
5	6		7
8
9	10

org

#+CAPTION: 示例表格
#+LABEL: tblref
   | head1 | head2 | head3 |
   |-------+-------+-------|
   | cell  | cell  | cell  |
   | cell  | cell  | cell  |

示例表格
head1	head2	head3
cell	cell	cell
cell	cell	cell

其他

混用HTML

<div style="background:#bbb;">
  HTML块中不能混用 **标记语法**
</div>

输出略。

ttl

<div style="background:#bbb;">
  HTML块中可以混用 **标记语法**
</div>

输出略。

禁止语法解析

rst

反斜线作为转义字符，\
禁止对后面 \*字符\* 做语法解析。

反斜线作为转义字符，禁止对后面 *字符* 做语法解析。

ttl

用 notextile 标记的段落不进行语法解析。

notextile. 不进行 *语法解析* 。

用 notextile 标记的段落不进行语法解析。

不进行 *语法解析* 。

注释

rst

.. 注释

..
   缩进内容也是注释

无输出。

asc

/
四个或更多的斜线包围起来的
文字块是注释，被忽略。
/

无输出。

org

# 行首井号是注释。

  #+ 缩进行首用 ``#+`` 标记为注释。


  #+BEGIN_COMMENT
   块注释
   ...
  #+END_COMMENT

无输出。

注解

部分标记语言代号后添加了星标，代表该标记语言相应的语法实现稍有区别，或者GitHub的具体实现和标准有出入。

本文链接：https://blog.csdn.net/idning/article/details/84127273

原作者删帖不实内容删帖广告或垃圾文章投诉

智能推荐

使用nginx解决浏览器跨域问题_nginx不停的xhr-程序员宅基地

文章浏览阅读1k次。通过使用ajax方法跨域请求是浏览器所不允许的，浏览器出于安全考虑是禁止的。警告信息如下：不过jQuery对跨域问题也有解决方案，使用jsonp的方式解决，方法如下：$.ajax({ async:false, url: 'http://www.mysite.com/demo.do', // 跨域URL ty..._nginx不停的xhr

在 Oracle 中配置 extproc 以访问 ST_Geometry-程序员宅基地

文章浏览阅读2k次。关于在 Oracle 中配置 extproc 以访问 ST_Geometry，也就是我们所说的使用空间SQL 的方法，官方文档链接如下。http://desktop.arcgis.com/zh-cn/arcmap/latest/manage-data/gdbs-in-oracle/configure-oracle-extproc.htm其实简单总结一下，主要就分为以下几个步骤。..._extproc

Linux C++ gbk转为utf-8_linux c++ gbk->utf8-程序员宅基地

文章浏览阅读1.5w次。linux下没有上面的两个函数，需要使用函数 mbstowcs和wcstombsmbstowcs将多字节编码转换为宽字节编码wcstombs将宽字节编码转换为多字节编码这两个函数，转换过程中受到系统编码类型的影响，需要通过设置来设定转换前和转换后的编码类型。通过函数setlocale进行系统编码的设置。linux下输入命名locale -a查看系统支持的编码_linux c++ gbk->utf8

IMP-00009: 导出文件异常结束-程序员宅基地

文章浏览阅读750次。今天准备从生产库向测试库进行数据导入，结果在imp导入的时候遇到“ IMP-00009:导出文件异常结束” 错误，google一下，发现可能有如下原因导致imp的数据太大，没有写buffer和commit两个数据库字符集不同从低版本exp的dmp文件，向高版本imp导出的dmp文件出错传输dmp文件时，文件损坏解决办法：imp时指定..._imp-00009导出文件异常结束

python程序员需要深入掌握的技能_Python用数据说明程序员需要掌握的技能-程序员宅基地

文章浏览阅读143次。当下是一个大数据的时代，各个行业都离不开数据的支持。因此，网络爬虫就应运而生。网络爬虫当下最为火热的是Python，Python开发爬虫相对简单，而且功能库相当完善，力压众多开发语言。本次教程我们爬取前程无忧的招聘信息来分析Python程序员需要掌握那些编程技术。首先在谷歌浏览器打开前程无忧的首页，按F12打开浏览器的开发者工具。浏览器开发者工具是用于捕捉网站的请求信息，通过分析请求信息可以了解请..._初级python程序员能力要求

Spring @Service生成bean名称的规则（当类的名字是以两个或以上的大写字母开头的话，bean的名字会与类名保持一致）_@service beanname-程序员宅基地

文章浏览阅读7.6k次，点赞2次，收藏6次。@Service标注的bean，类名：ABDemoService查看源码后发现，原来是经过一个特殊处理：当类的名字是以两个或以上的大写字母开头的话，bean的名字会与类名保持一致public class AnnotationBeanNameGenerator implements BeanNameGenerator { private static final String C..._@service beanname

随便推点

二叉树的各种创建方法_二叉树的建立-程序员宅基地

文章浏览阅读6.9w次，点赞73次，收藏463次。1.前序创建#include<stdio.h>#include<string.h>#include<stdlib.h>#include<malloc.h>#include<iostream>#include<stack>#include<queue>using namespace std;typed_二叉树的建立

解决asp.net导出excel时中文文件名乱码_asp.net utf8 导出中文字符乱码-程序员宅基地

文章浏览阅读7.1k次。在Asp.net上使用Excel导出功能，如果文件名出现中文，便会以乱码视之。解决方法： fileName = HttpUtility.UrlEncode(fileName, System.Text.Encoding.UTF8);_asp.net utf8 导出中文字符乱码

笔记-编译原理-实验一-词法分析器设计_对pl/0作以下修改扩充。增加单词-程序员宅基地

文章浏览阅读2.1k次，点赞4次，收藏23次。第一次实验词法分析实验报告设计思想词法分析的主要任务是根据文法的词汇表以及对应约定的编码进行一定的识别，找出文件中所有的合法的单词，并给出一定的信息作为最后的结果，用于后续语法分析程序的使用；本实验针对 PL/0 语言的文法、词汇表编写一个词法分析程序，对于每个单词根据词汇表输出： (单词种类, 单词的值) 二元对。词汇表：种别编码单词符号助记符0beginb..._对pl/0作以下修改扩充。增加单词

android adb shell 权限,android adb shell权限被拒绝-程序员宅基地

文章浏览阅读773次。我在使用adb.exe时遇到了麻烦.我想使用与bash相同的adb.exe shell提示符,所以我决定更改默认的bash二进制文件(当然二进制文件是交叉编译的,一切都很完美)更改bash二进制文件遵循以下顺序> adb remount> adb push bash / system / bin /> adb shell> cd / system / bin> chm..._adb shell mv 权限

投影仪-相机标定_相机-投影仪标定-程序员宅基地

文章浏览阅读6.8k次，点赞12次，收藏125次。1. 单目相机标定引言相机标定已经研究多年，标定的算法可以分为基于摄影测量的标定和自标定。其中，应用最为广泛的还是张正友标定法。这是一种简单灵活、高鲁棒性、低成本的相机标定算法。仅需要一台相机和一块平面标定板构建相机标定系统，在标定过程中，相机拍摄多个角度下（至少两个角度，推荐10~20个角度）的标定板图像（相机和标定板都可以移动），即可对相机的内外参数进行标定。下面介绍张氏标定法（以下也这么称呼）的原理。原理相机模型和单应矩阵相机标定，就是对相机的内外参数进行计算的过程，从而得到物体到图像的投影_相机-投影仪标定

Wayland架构、渲染、硬件支持-程序员宅基地

文章浏览阅读2.2k次。文章目录Wayland 架构Wayland 渲染Wayland的硬件支持简述：　翻译一篇关于和 wayland 有关的技术文章, 其英文标题为Wayland Architecture .Wayland 架构若是想要更好的理解 Wayland 架构及其与 X (X11 or X Window System) 结构；一种很好的方法是将事件从输入设备就开始跟踪, 查看期间所有的屏幕上出现的变化。这就是我们现在对 X 的理解。内核是从一个输入设备中获取一个事件，并通过 evdev 输入_wayland