Markdown介绍

Markdown介绍

Markdown是一种轻量级的标记语言。主要用于写出带有格式的文档。有点类似于HTML语言,但是语法要比HTML语言简单,十分适合书写文档。而且现在大部分博客和文章输入系统都支持这种语法。例如有道笔记和印象笔记等等。在Github上写的REAME.md就是这种语法写出来的说明文档。而且会在Github上直接显示出带有格式的文档结果。

Markdown优点

  1. 专注于文字内容,提供简单的排版语法。排版语法可以和文字内容融合。
  2. 很多的文字编辑工具支持这种语法。包括Atom,IDE,有道笔记,Evernote和博客网站。
  3. 容易学习,语法简单。
  4. 可以导出HTML,PDF文件
  5. 使用Word软件写出的文档无法记录修改的内容,而md文件可以使用Git软件记录更改的内容。追溯修改的过程。
  6. 扩展部分可以支持流程图,复杂的数学公式使用文字来描述。

Markdown语法

标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

Setext形式标题

类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

This is an H1
=============

This is an H2
-------------

Atx形式标题

文章的标题格式是最左侧加上#符号,之后有一个空格,最后右侧写上标题内容。一个井号代表一级标题,两个井号代表二级标题,以此类推,一共有6级。

# 这是 H1

## 这是 H2

###### 这是 H6

列表

无序列表

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

*   Red
*   Green
*   Blue

或者

+   Red
+   Green
+   Blue

等同于:

-   Red
-   Green
-   Blue

有序列表

有序列表是指在列表的每一行前面带有1, 2, 3...数字。这种列表需要在每一行文字前面增加数字+点的方式。例如"1."。然后再接文字。

引用

Markdown 标记区块引用是使用类似 email 中用 >的引用方式。使用大于号在文字前面。

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >

图片

图片是在一个对图片的连接,而不是能嵌入图片。有点像html的img标签的src属性。具体的写法为:![Alt text](image_url)

链接

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

行内参

格式为: [an example](http://example.com/ "Title").

一般简写成[an example](http://example.com/)

参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.

然后在下面的参考位置定义ID的值:
[id]: http://example.com/ "Optional Title Here"

链接网址也可以用尖括号包起来。

[id]: <http://example.com/>  "Optional Title Here"

隐式链接标记

隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 "Google" 链接到 google.com,你可以简化成:

[Google][]

然后定义链接内容:

[Google]: http://google.com/

链接的定义可以放在文件中的任何一个地方,我比较偏好直接放在链接出现段落的后面,你也可以把它放在文件最后面,就像是注解一样。

粗体

使用两个**和两个下划线围绕文字的左右侧。

斜体

使用*和一个下划线围绕文字的左右侧。

注意: 如果你的 *_ 两边都有空白的话,它们就只会被当成普通的符号。

表格

格式如下

|  列表头1       |  列表头2       |  列表头3  |
| ------------- |:-------------:| --------:|
| 内容1          | 内容2         | 内容3     |
| 内容1          | 内容2         | 内容3     |

上面的:代表对齐的方式。如果冒号两边都有那么代表居中对齐。

代码框。

代码框是程序员写的文档经常用到的。格式有多种,一种是使用单个反引号(一般在键盘的左侧tab键的上面),把代码包围起来。还有一种使用三个反引号把代码包围起来。如果代码是多行的,建议使用三个反引号比较好,其还可以指定代码的类型,例如是Python代码,或者HTML代码,这样显示的效果可以带有语法高亮。

分隔线

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

转义字符

Markdown语法使用的字符如何与你写的文档中的字符有冲突,那么可以使用\来转义Markdown的字符,变成普通的文字符号。

Markdown提供对如下字符的转义:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

特殊字符

Markdown兼容HTML中一些特殊字符写法。例如版权符号使用@copy;


参考:

posted @ 2017-04-04 12:46  kris_zhang  阅读(420)  评论(0编辑  收藏  举报