Markdown 语法入门
一.概述
Markdown 是一种轻量级标记语言, 由 John Gruber 设计, 目标是实现 [易读易写] . 本文参考 markdown.cn .
二.规则
1.标题
标题格式在文字前加 # 号 :
# 一级标题
## 二级标题
### 三级标题
以此类推, 总共六级标题, 建议在 # 号后加一个 空格 , 这是最标准的 Markdown 语法.
2.列表
有序列表
有序列表用 数字 + 英文句点 的方式:
1. Rad
2. Green
3. Blue
无序列表
无序列表用 * 或 + 或 - 的方式 ( 三种效果是一样的 ) :
* Red
* Green
* Blue
3.引用
引用别处的句子用引用的格式, 每行文本前加 > :
> 这是一段引用
引用可以嵌套, 也可以使用其他 Markdown 语法.
4.链接和图片
链接和图片语法接近, 区别在于开头位置的 ! :
[Google](https://www.google.com/)
上述为 行内式 , 还有一种 参考式 , 即用标记来辨识链接, 链接标记可以在文件任意处定义 :
[Google][Google_Link]
[Google_Link] https://www.google.com/ (Google Link)
有一种 隐式链接标记 方式, 链接标记和链接文字一致 :
[Google][]
[Google] https://www.google.com/ (Google Link)
markdown中图片不支持设置对齐方式和自定义宽和高.
链接还有一种简单的写法 https://www.google.com , [email protected] :
5.粗体和斜体
斜体用 1个 * 或 1个 _ 包含, 粗体用 2个 * 或 2个 _ 包含 的方式 ( * 和 _ 效果是一样的 ) :
**这是粗体写法**
*这是斜体写法*
几种特殊的文字标记方式 ( 内联方式 ) :
delete line
Much wow
So doge
So good
~~delete line~~
Much wow
So doge
So good
6.表格
表格的格式比较复杂, 格式如下 :
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
需要留意的地方是用 : 设置对齐方式, 单一设置 |: 或 :| 为居左或居右对齐, 同时设置为居中对齐.
7.代码块
单行代码用 `code`
printf("Hello worldddd!\n");
def inc(x):
return x + 1
print inc(10)
代码块中插入 ` , 可以用多个 ` 开始和结束代码, 也可以在 ` 前加 一个空格 .
8.分隔符
在一行中用三个以上的 * 或 - 或 _ 来建立一个分隔线, 行内不能有其他东西. 可以在星号或是减号中间插入空格 :
9.换行
特别容易忽略换行符的格式, 换行符由 2个以上的空格 + 1个回车 或者 两个回车 组成.