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 > 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 Text attributes italic,
bold, Horizontal rule: Bullet list:
Numbered list:
A link.
Inline HTML is supported. |