CSDN Markdown 编辑器 第三篇 基本语法篇
这一篇准备抄一下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
- 列表内容
- 列表内容
-
有序列表的使用,在数字及符号“.”后加空格几个,如下:
1. 有序列表1
2. 有序列表2
3. 有序列表2.1
4. 有序列表2.2
- 这
- 无
1. 有
2. 序
- 序
3. 有序列表3
- 有序列表1
- 有序列表2
1. 有序列表2.1
2. 有序列表2.2
* 这
* 无
1. 有
2. 序
* 序
- 有序列表3
有序列表如果要区分层级,也可以在数字前加空格或者tab。
3. 引用
引用的格式是使用符号“>”后面书写文字. ”>“之后是否加空格不影响。如下:
> 我说的都是我说的——帐前卒
我说的都是我说的——帐前卒
4. 粗体和斜体
粗体和斜体: 一个 *
两个 *
还是三个 *
. 注意 **[你的字符]**
中 *
号和你的字符之间没有空格。
一个 *
: *你是斜体*
_ 你是斜体 _
两个 *
: **不对,你是粗体**
** 不对,你是粗体 **
三个 *
: ***你又粗又斜***
** _ 你又粗又斜 _ **
5. 链接
- 在引用中加链接,第一个中括号添加需要添加的文字,第二个中括号中是引用链接的id,之后在引用中,使用id加链接:如下:
[link text][id]
[id]: http://example.com/ “optional title here”
上面的文字将展示为:
link text
- 在文中直接引用链接,直接使用尖括号,把链接加入到尖括号中就可以实现,如下:
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