Markdown常用语法说明

  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个空格 + 回车来进行标识,正常的换行不会进行换行。

 

posted @ 2022-01-13 19:29  PC君  阅读(355)  评论(0编辑  收藏  举报