MarkDown 语法详解

2017/10/31 MarkDown

什么是 MarkDown

什么是 MarkDown ? MarkDown 是一种轻量级的 「标记语言」,通常为程序员群体所使用。目前它已经是全球最大的 技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用格式。

MarkDown 语法说明

  • 概述
    • 宗旨
    • 兼容 HTML
  • 区块元素
    • 段落和换行
    • 标题
    • 区块引用
    • 列表
    • 代码区块
    • 分割线
    • 删除线
  • 区段元素
    • 粗体和斜体
    • 连接
    • 图片
  • 高级制表
    • 表格
  • 其他
    • 反斜杠
    • 自动连接
  • 感谢

概述

宗旨

MarkDown 的目标是实现 「易读易写」。

可读性非常的重要,一份由 MarkDown 编写的文件可以以纯文本的方式直 接发布,并且看起来不会有许多标签或格式指令构成 。

兼容HTML

Markdown 语法的目标是:成为一种适用于网络的书写语言。

Markdown 不是想要取代 HTML ,甚至也没有要和它相近,它的语法种类很少, 只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容 易书写。在我看来,HTML 已经很容易写了。Markdown 的理念是,能让文档更 容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。 就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

区块元素

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上 的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一 行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符 来缩进。

标题

MarkDown 标题语法

区块引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

有序列表则使用数字接着一个英文句点:

代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些 区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示。

分割线

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

删除线

~~删除线~~

删除线

区段元素

粗体和斜体

Markdown 的粗体和斜体也非常简单:

用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。

连接

链接:在 Markdown 中,插入链接只需要使用 [显示文本](链接地址) 即可。 我的博客

图片

很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。 Markdown 使用一种和链接很相似的语法来标记图片。

![](/images/blog/lianjie.png)

到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。

高级制表

表格

| Item        |  Value        | Qty      |
| :----       |   -----:      |  :---:   |
| 学生        |  30人          | 20      |
| 老师        |  3人           | 40      |

其他

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如 你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标 签),你可以在星号的前面加上反斜杠:

\*literal asterisks\*

自动连接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要 是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字 就和链接地址一样,例如:

<http://chaodongyang.com/>
<address@163.com>

邮址的自动链接也很类似,只是 Markdown 会先做一个编码转换的过程,把文 字字符转成 16 进位码的 HTML 实体,这样的格式可以糊弄一些不好的邮址收 集机器人,例如:

Markdown 会转成:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

感谢

参考地址

Show Disqus Comments

Search

    欢迎关注我的微信公众号

    Android开发吹牛皮

    Table of Contents