特殊字符自动转换

区块元素

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。(此段前后都有一个空行)

普通段落用空格进行缩进无效果(此段前面有一个空格)

普通段落不要使用制表符进行缩进,使用制表符缩进的话,会当成代码区块(此段前面有一个制表符)

段落内的强迫换行(插入换行符),(在此处换行)
在插入处先按入两个以上的空格然后回车(会转换为<br>)

标题

行首插入 1 到 6 个 # ,对应到标题 h1 到 h6 (#号与内容之间有一个空格)

区块引用Blockquotes

1.Markdown 标记区块引用是使用类似 email 中用 > 的引用方式,在每行前面加上 > 号,也可以只在第一行前面加上 > 号

2.区块引用可以嵌套(例如:引用内的引用),

只要根据层次加上不同数量的 >

例如三层的

3.引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

列表

  • 无序列表使用星号、加号或是减号作为列表标记
  • 使用星号作为列表标记
  • 使用加号作为列表标记
  • 使用减号作为列表标记
  1. 有序列表使用数字接着一个英文句点。
  2. 很重要的一点是,你在列表标记上使用的数字并不会影响输出的 HTML 结果。
  3. 比如用‘1. 1. 1. ’甚至‘3. 1. 8.’,显示出来都是按顺序的‘1. 2. 3.’

代码区块

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。Markdown 会用 <pre> 和 标签来把代码区块包起来

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理,例如:

<div class="footer">
  &copy; 2004 Foo Corporation
</div>

代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格,下方是分别用星号、减号、底线建立的分割线:





区段元素

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,不管是哪一种,链接文字都是用 [方括号] 来标记。

行内式的链接是比较常用也比较方便的,例如:

This link has a title attribute.格式:[链接文字](链接地址 "标题")

This link has no title attribute.格式:[链接文字](链接地址 )

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记,:

This is an example reference-style link.

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接

<http://example.com/> 会被转化为 <a href=”http://example.com/”>http://example.com/</a>

<address@example.com> 会被转化为 <a href=”mailto:address@example.com”>address@example.com</a>

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 标签包围,用两个 * 或 _ 包起来的话,则会被转成 ,但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号,例如:

用 * 包起来

用 _ 包起来

用 ** 包起来

用 __ 包起来

星号两边都有空白 * ,会被当成普通符号 *

底线两边都有空白 _ ,会被当成普通符号 _

代码

如果要标记一小段行内代码,你可以用反引号把它包起来(`),Markdown解析会用<code>标签把它包起来,例如:

Use the printf() function.

图片

Markdown 使用一种和链接很相似的语法来标记图片

  (1)普通格式:![图片的替代文字](图片链接地址)

![Alt text](https://www.baidu.com/img/baidu_jgylogo3.gif)

Alt text

  (2)带标题的格式:![图片的替代文字](图片链接地址 “图片标题”)

![Alt text](https://www.baidu.com/img/baidu_jgylogo3.gif "百度")

Alt text

  (3)带css样式的格式:![图片的替代文字](图片链接地址 “图片标题”){:属性名称1=”属性值1” 属性名称2=”属性值2”}

![Alt text](https://www.baidu.com/img/baidu_jgylogo3.gif){:width="200px" height="100px"}

Alt text




参考