教你使用Markdown写博客

Markdown基本语法

原创-转载请注明出处

标题

＃——###### 分别代表 h1--h6
比如 #### text

text

区块引用

1.可以在每一行都加上引用，也可以只在段落之前加上引用
> 这里填写要引用的文字
2.区块引用可以嵌套
>> 这里填写要嵌套的文字
3.区块内部也可以使用其他语法
> #### text

这里是正文

这里填写要引用的文字

text

列表

无序列表

*号之前加上制表符会有多级效果

* 苹果
* 香蕉
    * 梨

*另外： + - 三者效果相同 **

• 苹果
• 香蕉
  • 梨

有序列表

使用数字加上英文句点
1. 苹果
2. 香蕉
3. 梨
6. 草莓

另外注意一点，列表标记的数字并不会影响结果，即使是乱序排列，Markdown也会自动排序成有序的

1. 苹果
2. 香蕉
3. 梨
4. 草莓

其他

• 强制换行，在语句后面加上两个空格
• 用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> 标签。

• 关于 序列图 语法，参考 这儿,
• 关于 流程图 语法，参考 这儿.

先写到这里，有新的东西再继续补充。

---