使用Markdown写博客

Markdown基本语法

标题

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

text

区块引用

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

这里是正文

这里填写要引用的文字

####text

列表

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

* 苹果
* 香蕉
    * 梨

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

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

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

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

其他

  • 强制换行,在语句后面加上两个空格
  • 用markdown语法时,在关键字符后面尽量加上空格,不然可能语句会不生效,例如 # text

Markdown及扩展

标记语言

> Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。      
—— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 维基百科 ]

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]

字体,链接

使用简单的符号标识不同的标题,将某些文字标记为**粗体**或者*斜体*,创建一个[链接](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(这里写哪种语言)
代码块
```

1
2
3
4
5
6
7
8
9
10
@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)

{% image /path/to/img.jpg 'Alt text' 'Optional' %}  

详细叙述如下:

一个惊叹号 !  
接着一个方括号,里面放上图片的替代文字(可以不填)  
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。  
参考式的图片语法则长得像这样:  

![Alt text][id]

到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 标签。

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

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