Markdown快速入门
- 标题、区块引用
(1)用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)
(2)在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶
(3)区块引用则使用 email 形式的 '>' 角括号。
Markdown 语法:
最高阶标题
========
第二阶标题
--------
### H3
> 这是区块引用
> > 这是区块引用的嵌套
> ## 在区块引用里使用H2
> 只在整个段落的第一行最前面加上 >只在整个段落的第一行最前面加上只在
整个段落的第一行最前面加上只在整个段落的第一行最前面加上
输出 HTML 为:
- 修辞和强调
Markdown 使用星号( * )和底线( _ )作为标记强调字词的符号,被 * 或 _ 包围的字词为斜体,用两个 * 或 _ 包起来的话,则加粗
星号(*)和底线你可以任意选择,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
Markdown 语法:
*斜体*.
_斜体_
**加粗**
__加粗__
\*星号或底线前插入反斜线,会被渲染成普通的星号或底线\*
如果星号或底线 * 和 _ 两边都有空白的话,会被渲染成普通的星号或底线
输出 HTML 为:
斜体.
斜体
加粗
加粗
*星号或底线前插入反斜线,会被渲染成普通的星号或底线*
如果星号或底线 * 和 _ 两边都有空白的话,会被渲染成普通的星号或底线
- 代码区块
(1)只要缩进 4 个空格或是 1 个制表符(Tab)就可建立代码区块
(2)一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)
(3)代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,你只需要复制贴上HTML 原始码,再加上缩进就可以了,剩下的 Markdown 都会帮你处理
(4)代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以在代码区块中以 Markdown 语法撰写 Markdown 语法相关的文件。
Markdown 语法:
这是一个普通段落:
这是一个代码区块(上面必须空一行)。
<div class="footer">
© 2004 Foo Corporation
</div>
输出 HTML 为:
这是一个普通段落:
这是一个代码区块(上面必须空一行)。
<div class="footer">
© 2004 Foo Corporation
</div>
- 代码
(1)如果要标记一小段行内代码,你可以用反引号把它包起来(`)
(2)如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段:
(3)在代码区段内,& 和尖括号都会被自动地转成 HTML 实体
Markdown 语法:
标记一小段行内代码 `printf()`用反引号把它包起来(`)
``要在代码区段内插入反引号 (`) 可以用多个反引号来开启和结束代码区段``
在区段的中插入反引号`` `foo` ``
Please don't use any `<blink>` tags.
输出 HTML 为:
标记一小段行内代码 printf()
用反引号把它包起来(`)
要在代码区段内插入反引号 (`) 可以用多个反引号来开启和结束代码区段
在区段的中插入反引号`foo`
Please don't use any <blink>
tags.
- 列表
Markdown 支持有序列表和无序列表,项目标记后面则一定要接着至少一个空格或制表符(符号后面至少要空一个空格)
(1)无序列表使用星号、加号或是减号作为列表标记
(2)有序列表则使用数字接着一个英文句点
(3)重点在于,有序列表,可以完全不用在意数字的正确性。
(4)用Tab可以缩进分层
Markdown 语法:
* 无
* 序
* 列
+ 表
+ ....
+ 无
- 序
- 列
- 表
中间要用文字隔开
1. 有
4. 序
3. 列
2. 表(不用在意数字顺序,无影响,但最好从1开始)
1986\. 在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
输出 HTML 为:
- 无
- 序
- 列
- 表
- ....
- 无
- 序
- 列
- 表
中间要用文字隔开
- 有
- 序
- 列
- 表(不用在意数字顺序,无影响,但最好从1开始)
1986. 在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
- 链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,链接文字都是用 [方括号] 来标记。
(1)行内式,方块括号内是文字,后面圆括号里面是网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
(2)如果你是要链接到同样主机的资源,你可以使用相对路径:
Markdown 语法:
[百度链接](https://www.baidu.com/ "我是Title") 行内式
[About](/about/) 链接到同样主机的资源,你可以使用相对路径
输出 HTML 为:
百度链接 行内式
About 链接到同样主机的资源,你可以使用相对路径
- 图片
Markdown 使用一种和链接很相似的语法来标记图片,允许两种样式: 行内式和参考式。
(1)行内式,方块括号内是文字,后面圆括号里面是网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
(2)详细叙述如下:
- 一个惊叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
Markdown 语法:
![当图片不现实的时候我出现](/path/to/img.jpg "当鼠标放在上面的时候我出现")
![Alt text](./1524562628039.png)
输出 HTML 为:
- 分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
Markdown 语法:
* * *
***
*****
- - -
---------------------------------------
输出 HTML 为:
- 反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠
Markdown 语法:
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
\*literal asterisks\*
输出 HTML 为:
*literal asterisks*