Markdown

来自维基学院

语法[编辑 | 编辑源代码]

图片[编辑 | 编辑源代码]

![中文维基学院LOGO](https://upload.wikimedia.org/wikipedia/commons/5/58/Wikiversity-logo-zh.svg)

换行[编辑 | 编辑源代码]

在文本中输入的换行会从最终生成的结果中删除,浏览器会根据可用空间自动换行。如果想强迫换行,可以在行尾插入至少两个空格。

强调[编辑 | 编辑源代码]

*强调* 或者 _强调_(示例:斜体)

 
**加重强调** 或者 __加重强调__

又或者以制表符或至少四个空格缩进的行,例如:

    第一行代码
    第二行代码
    第三行代码

后面一种用法会让Markdown保留所有的空白字符——而与之相反,一般情况下,Markdown会删除所有换行和空格,打乱原有的缩进和排版。

标题[编辑 | 编辑源代码]

可以在标题内容前输入特定数量的井号#来实现对应级别的HTML样式的标题(HTML提供六级标题)。例如:

# 一级标题

#### 四级标题

一级和二级标题还有一种写法:

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

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

断行[编辑 | 编辑源代码]

如果你真的想在Markdown中插入换行标签<br/>,你可以在行尾输入两个或以上的空格,然后回车。 这样插入换行十分麻烦,而且“每个换行都转换为<br/>”在 Markdown中并不合适,所以只在你确定你需要时手动添加。

引用[编辑 | 编辑源代码]

引用只需要在被引用的内容段落开头加上右尖括号>即可。你可以选择只在开头加一个。也可以在每行前面都加一个,效果是一样的。

> 这一整段的内容都会作为一个HTML的引用元素。
引用元素是会自动优化排版的(reflowable,可回流)。
你可以任意地将引用的内容包含进来,然后所有这些都会
被解析成为单独一个引用元素。

上述内容会转换成以下HTML内容:

<blockquote><p>这一整段的内容都会作为一个HTML的引用元素。引用元素是会自动优化排版的(reflowable,可回流)。
你可以任意地将引用的内容包含进来,然后所有这些都会被解析成为单独一个引用元素。</p></blockquote>

引用可以嵌套。如果要在一个引用里插入一个引用,可以用两个>开头。依此类推,根据嵌套层次加相应数量的符号。

> 这是一个引用。这是第一行
这是第二行。
>> 这是一个嵌套的引用。这是第一行。
这是第二行
> 
> 外层引用的第三行。前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的>可以有可以没有。

链接[编辑 | 编辑源代码]

链接可以在行内插入:

[链接文字](链接地址)
例子: [Markdown](http://zh.wikipedia.com/wiki/Markdown)

另一种选择是,链接地址可以放在段落后面的脚注,前面放上链接引用标签区分。举例说,先在内容行内插入以下内容:

[链接文字][链接引用标签]

然后在段落的后面(或者文档的结尾)放上以下内容,就可以生成一个链接:

[链接引用标签]: 链接地址 "链接标题"

水平分割线[编辑 | 编辑源代码]

要生成水平分割线,可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条水平分割线。

* * *
***
*****
- - -
---------------------------------------

Markdown與HTML轉換之例子[编辑 | 编辑源代码]

Text using Markdown syntax Corresponding HTML produced by a Markdown processor Text viewed in a browser
# 標題

## 二級標題

Paragraphs are separated
by a blank line.

Two spaces at the end of a line  
produces a line break.

Text attributes _italic_, 
**bold**, `monospace`.

Horizontal rule:

---

Bullet list:

  * apples
  * oranges
  * pears

Numbered list:

  1. wash
  2. rinse
  3. repeat

A [link](http://example.com).

![Image](Image_icon.png)

> Markdown uses email-style > characters for blockquoting.

Inline <abbr title="Hypertext Markup Language">HTML</abbr> is supported.
<h1>標題</h1>

<h2>二級標題</h2>

<p>Paragraphs are separated
by a blank line.</p>

<p>Two spaces at the end of a line<br />
produces a line break.</p>

<p>Text attributes <em>italic</em>, 
<strong>bold</strong>, <code>monospace</code>.</p>

<p>Horizontal rule:</p>

<hr />

<p>Bullet list:</p>

<ul>
<li>apples</li>
<li>oranges</li>
<li>pears</li>
</ul>

<p>Numbered list:</p>

<ol>
<li>wash</li>
<li>rinse</li>
<li>repeat</li>
</ol>

<p>A <a href="http://example.com">link</a>.</p>

<p><img alt="Image" src="Image_icon.png" /></p>

<blockquote>
<p>Markdown uses email-style &gt; characters for blockquoting.</p>
</blockquote>

<p>Inline <abbr title="Hypertext Markup Language">HTML</abbr> is supported.</p>

Paragraphs are separated by a blank line.

Two spaces at the end of a line
produces a line break.

Text attributes italic, bold, monospace.

Horizontal rule:


Bullet list:

  • apples
  • oranges
  • pears

Numbered list:

  1. wash
  2. rinse
  3. repeat

A link.

Image

Markdown uses email-style > characters for blockquoting.

Inline HTML is supported.

參考[编辑 | 编辑源代码]

维基百科中的相关条目: