这一篇准备抄一下help文档,另外加一些自己的解释。这一篇里不讲UML和LaTEX。 准备抽两个篇专门讲一下。
1. 标题与字号
markdown字号太少了,觉得应该再加些。
在文字写书写不同数量的#可以完成不同的标题,如下:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
这里的需要注意的是 #[空格]标题 一定要有空格
等号及减号也可以进行标题的书写,不过只能书写二级标题,并且需要写在文字的下面,减号及等号的数量不会对标题的字号产生影响,如下:
二级标题
=========
二级标题
---------
二级标题
二级标题
一直觉得这个语法是对诡异的。因为-
极可能是无序列表中的第一行。所以这个语法判断时候,还要判断-
后面是否有一个空格。感觉文法很不舒服。这是为什么呢?
解析一下:markdown文法类似
从A到B的转移通过字符-
,在B状态下markdown认为这个上面的字符都要加粗。如果下一个字符是[空格],那么markdown认为是一个无序列表,将上面一行的所有文字的状态置为不加粗。虽然这个是状态的改变。但是在我们眼里,这是之前文字的状态改变。所以我们觉得这个文法就不舒服。因为我们习惯于向同一个方向书写。而不是写着写着回顾另外一个方向。
2. 有序和无序
无序列表的使用,在符号“-”后加空格使用。如下:
另外注意 -
一定要是开始字符,如果不是那么-
之前只能有空格或者tab字符。
- 无序列表1
- 无序列表2
- 无序列表3
- 无序列表1
- 无序列表2
- 无序列表3
如果要控制列表的层级,则需要在符号“-”前使用空格或者tab。如下:
- 无序列表1
- 无序列表2
- 无序列表2.1
- 列表内容
- 列表内容
- 无序列表1
- 无序列表2
- 无序列表2.1
- 列表内容
- 列表内容
- 无序列表2.1
有序列表的使用,在数字及符号“.”后加空格几个,如下:
1. 有序列表1
2. 有序列表2
3. 有序列表2.1
4. 有序列表2.2
- 这
- 无
1. 有
2. 序
- 序
3. 有序列表3
- 有序列表1
- 有序列表2
- 有序列表2.1
- 有序列表2.2
- 这
- 无
- 有
- 序
- 序
- 有序列表3
有序列表如果要区分层级,也可以在数字前加空格或者tab。
3. 引用
引用的格式是使用符号“>”后面书写文字. ”>“之后是否加空格不影响。如下:
> 我说的都是我说的——帐前卒
我说的都是我说的——帐前卒
4. 粗体和斜体
粗体和斜体: 一个*
两个*
还是三个*
. 注意**[你的字符]**
中*
号和你的字符之间没有空格。
一个*
:*你是斜体*
你是斜体
两个*
:**不对,你是粗体**
不对,你是粗体
三个*
:***你又粗又斜***
你又粗又斜
5. 链接
- 在引用中加链接,第一个中括号添加需要添加的文字,第二个中括号中是引用链接的id,之后在引用中,使用id加链接:如下:
[link text][id]
[id]: http://example.com/ "optional title here"
上面的文字将展示为:
- 在文中直接引用链接,直接使用尖括号,把链接加入到尖括号中就可以实现,如下:
http://example.com/ or [email protected]
展示如下:
http://example.com/ or [email protected]
- 插入互联网上图片,格式如下:
![这里写图片描述](http://img3.douban.com/mpic/s1108264.jpg)
或者如下面的写法:
![这里写图片描述][jane-eyre-douban]
[jane-eyre-douban]: http://img3.douban.com/mpic/s1108264.jpg`
## 6. 代码块
- 如果在一个行内需要引用代码,只要用反引号`引起来就好,如下:
Use the `printf()` function.
- 用TAB键起始的段落,会被认为是代码块,如下:
echo “hello world”;
- 如果TAB不管用的话,需要使用三个反引号` 例如:
下面连高亮都做了。
<php>
echo "hello world";
</php>
7. 分割线和删除线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,同时需要在分隔线的上面空一行。如下:
---
****
___
展示如下:
删除线的使用,在需要删除的文字前后各使用两个符号“~”,如下
~~Mistaken text.~~
Mistaken text.
8. 表格
可以使用冒号来定义表格的对齐方式,如下:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
| somemissed |
|||$20|
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
somemissed | ||
$20 |