Markdown是一种轻量级标记语言。其原理也很简单,就是在我们编写纯文本的文档时,加入一些简单的语法标记,然后通过这些标记转换成有效的XHTML(或者HTML)格式文档。现在很多编辑器都支持Markdown语法进行文档书写,要注意的是,虽然预览效果整体上都差不多,但不同的编辑器在预览效果上会有一些差异,有些编辑器还支持自定义效果。Typora应该是最常用的(),下面的效果也是以Typora效果为例。来看看比较常用的一些语法。
一、标题
方法1:一般使用' # '的个数 + 空格,来标识几级标题。共 6 级标题,再多不识别。
# h1
## h2
### h3
#### h4
##### h5
###### h6
注:一级标题,二级标题会默认带一个分隔线
方法2:大于1个的' = '、' - '分别表示一级标题、二级标题,效果跟上面一样。
h1
===
h2
---
二、强调
斜体:*文本1* 或 _文本1_
加粗:**文本2** 或 __文本2__
加粗斜体:***文本3*** 或 ___文本3___
三、删除线
用2个波浪号标识。
~~这是一条删除线~~
四、分隔线
至少3个' * '或' + '或' _ '来标识,中间有空格不连续也可以,效果都是一样的。
***
* * *
---
- - -
___
_ _ _
五、代码块
(1)单行,首尾使用1个' ` '来标识。
使用`Tab`键。
(2)多行,首尾使用3个' ` '来标识。
```注释
public static void main(String[] args) {
System.out.println("Test");
}
```
六、列表
(1)有序列表,数字 + ' . ' + 空格。
1. xxxxx
2. xxxxx
3. xxxxx
(2)无序列表,' - '或' + '或' * ' + 空格。也支持嵌套,在前面使用 tab 或 空格 来缩进,来控制列表的层级关系。
- x
- xx
- xxx
+ x
+ xx
+ xxx
* xxx
* xxx
* xxxx
* xxxxx
* xxx
七、引用
使用' > '来标识,可以嵌套引用,理论上无限嵌套。
> 一级
>> 二级
>>> 三级
>>>> 四级
八、链接
方法1:行内式,使用中括号标识页面文字,小括号标识链接地址,还可加空格带字符串说明。
[百度地址](https://www.baidu.com/)
[百度地址](https://www.baidu.com/ '我是说明')
方法2:参考式,使用中括号标识页面文字,再跟一个中括号标记变量名称,然后可以在文章任意地方对变量进行定义。
[百度地址][id]
[id]: http://www.baidu.com/ "我是说明"
参考式的简写方式,即省略变量名称,定义的时候,直接用页面文字进行关联。
[百度地址][]
[百度地址]: http://www.baidu.com/ "我是说明"
九、图片
与链接一样,只需在前面再加个感叹号,也可以使用行内式和参数式。
![图片提示](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
十、表格
方法1:通过竖线分割出表格,冒号代表对齐方式,靠左标识左对齐,靠右标识右对齐,两边都有标识居中对齐。
|name|age|sex|
|:-:|-:|:-|
|tom|5|男|
|jerry|3|女|
方法2:其实跟方法1类似,更简洁,省略了两侧的竖线,不过部分编辑器识别起来不太顺利。
name|age
-|-
tom|5
lucy|3
十一、转义
通过反斜杠转义,可以在文档中输出上面提到作为标记的一些符号。
\*文本1\*
十二、扩展功能
很多编辑器还支持一些便捷的语法。
(1)目录
可以使用[TOC]命令自动生成文档的目录,当然你也可以自己用列表+链接去实现。
(2)脚注
使用中括号 + ' ^ ' +变量名来标识,鼠标悬浮可以查看定义的脚注。
这是一句话[^1]。
[^1]: 这是脚注。
(3)换行
有些编辑器需要使用2个空格 + 回车来进行标识,正常的换行不会进行换行。