Markdown————快速入门
2017-08-08 本文已影响0人
晴天sy
Markdown
1. 兼容HTML
Markdown语法的目标是:成为一种适用于网络的书写语言。
Markdown的理念是,能让文档更容易读、写和随意改。
- 一些HTML区块元素必须在前后加上空行与其它内容区隔开,还要求开始标签与结尾标签不能用制表符或空格来缩进。
- 在 HTML 区块标签间的 Markdown 格式语法将不会被处理
- HTML的区段(行内)标签可以在Markdown的段落、列表或是标题里随意使用
- 和处在HTML区块标签间不同,Markdown 语法在 HTML区段标签间是有效的
2. 特殊字符自动转换
html中特殊处理字符<和&,实体形式: <和& 想要显示这些字符的原型,必须要使用实体的形式。
Markdown自动转换特殊字符,如果使用的&字符是HTML字符实体的一部分,会保留原状,否则会被转换成 &。
3. 区块元素
- 段落
由一个或多个连续的文本行组成,它的前后要有一个以上的空行 - 换行
插入<br />标签,在插入处先按入两个以上的空格然后回车。 - 标题语法
两种标题语法
- Setext: 用底线形式,=(最高阶标题) -(第二阶标题)
- atx: 行首插入1到6个#,对应标题1到6阶
-
区块引用 >
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等 -
列表
无序列表 行首位置使用星号、加号和减号来做为列表的项目标记
有序列表 行首使用一般的数字接着一个英文句点作为项目标记
- 项目标记后面则一定要接着至少一个空格或制表符
- 在项目之间插入空行,那项目的内容会用<p>包起来
- 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
- 在列表项目内放进引用,那 > 就需要缩进
- 要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
- 在行首出现数字-句点-空白,要避免这样的状况,可以在句点前面加上反斜杠。
- 代码区块
建立代码区块缩进4个空格或是1个制表符。Markdown会用<pre>和<code>标签来把代码区块包起来 - 分隔线
在一行中用三个以上的星号、减号、底线来建立一个分隔线。也可以在星号或是减号中间插入空格
4. 区段元素
- 修辞和强调
使用星号和底线连标记需要强调的部分
斜体 *内容* 或者 _内容_
加粗 **内容** 或者 __内容__ - 链接
行内和参考两种形式,链接文字用[方括号]来标记
- 行内
方块括号后圆括号内插入网址链接
eg: This is an [example link](http://example.com/).
title属性
eg: [example link](http://example.com/ "With a Title"). - 参考
在链接文字的括号后面再接上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记
eg:
from [Google][1] than from [Yahoo][2] or [MSN][3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ 'Yahoo Search'
[3]: http://search.msn.com/ (MSN Search)
链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写
- 图片
类似链接,行内和参考两种形式
- 行内
![alt text](/path/to/img.jpg "Title") - 参考
![alt text][id]
[id]: /path/to/img.jpg "Title"
- 代码
使用反引号 ` 来标记代码区段
如果建立一个已经格式化好的代码区块,每行都缩进4个空格或是一个tab。 - 其它
- 自动链接
用尖括号包起来,Markdown就会自动把它转成链接。一般网址的链接文字就和链接地址一样。 - 反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
\ 反斜线
` 反引号
- 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
文章内容只是对如何快速运用Markdown写文本进行的阐述,如需进行详细了解,请链接下面地址
Markdown