Markdown基本语法
原创-转载请注明出处
标题
#——###### 分别代表 h1--h6
比如 #### text
text
区块引用
1.可以在每一行都加上引用,也可以只在段落之前加上引用
> 这里填写要引用的文字
2.区块引用可以嵌套
>> 这里填写要嵌套的文字
3.区块内部也可以使用其他语法
> #### text
这里是正文
这里填写要引用的文字
text
列表
无序列表
*号之前加上制表符会有多级效果
* 苹果
* 香蕉
* 梨
*另外: + - 三者效果相同 **
- 苹果
- 香蕉
- 梨
有序列表
使用数字加上英文句点
1. 苹果
2. 香蕉
3. 梨
6. 草莓
另外注意一点,列表标记的数字并不会影响结果,即使是乱序排列,Markdown也会自动排序成有序的
- 苹果
- 香蕉
- 梨
- 草莓
其他
- 强制换行,在语句后面加上两个空格
- 用markdown语法时,在关键字符后面尽量加上空格,不然可能语句会不生效,例如 # text
Markdown及扩展
标记语言
> Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。
—— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 维基百科 ]
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 维基百科 ]
字体,链接
使用简单的符号标识不同的标题,将某些文字标记为**粗体**或者*斜体*,创建一个[链接](http://ibat.xyz)等
使用简单的符号标识不同的标题,将某些文字标记为粗体或者斜体,创建一个链接等
表格
Markdown 表格语法:
项目 | 价格
-------- | ---
Computer | $1600
iPhone | $12
iPad | $1
项目 | 价格 |
---|---|
Computer | $1600 |
iPhone | $12 |
iPad | $1 |
可以使用冒号来定义对齐方式:
| 项目 | 价格 | 数量 |
| :-------- | --------:| :--: |
|左对齐 |右对齐 |居中 |
| Computer | 1600 元 | 5 |
| iPhone | 12 元 | 12 |
| iPad | 1 元 | 234 |
项目 | 价格 | 数量 |
---|---|---|
左对齐 | 右对齐 | 居中 |
Computer | 1600 元 | 5 |
iPhone | 12 元 | 12 |
iPad | 1 元 | 234 |
代码块
代码块语法遵循标准markdown代码,例如:
``` python(这里写哪种语言)
代码块
```
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
简单的四个空格或者一个制表符生成代码块
这里放代码区块
图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字(可以不填)
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
参考式的图片语法则长得像这样:
![Alt text][id]
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。
先写到这里,有新的东西再继续补充。