Markdown基本语法

最新推荐文章于 2023-02-07 19:25:17 发布

卢同学.

最新推荐文章于 2023-02-07 19:25:17 发布

阅读量507

点赞数

分类专栏： Markdown 文章标签： markdown

原文链接：https://www.jianshu.com/p/b03a8d7b1719

版权

Markdown 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

一、基本介绍

1.概念

Markdown是一种纯文本格式的标记语言。通过简单的标记语法可以使普通文本内容具有一定的格式。

2.优点

1.因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。
2.操作简单。

3.缺点

1.需要记一些语法（比较简单）。
2.有些平台不支持Markdown编辑模式。目前支持Markdown编辑模式的有：简书、CSDN等网站。

二、基本语法

规则：标准语法一般在#后加个空格再写文字，有的不加空格也行。

1.标题

方法：一个#是一级标题，二个#是二级标题，以此类推，支持六级标题。
示例：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.字体

2.1加粗
方法：要加粗的文字左右分别用两个"*“号或”_"号包起来

示例1：**加粗**
示例2：__加粗__

效果：
示例1：加粗
示例2：加粗

2.2斜体
方法：要倾斜的文字左右分别用一个"*“号或”_"号包起来

示例：*斜体*  或者  _斜体_

效果：
示例：斜体或者斜体

2.3删除线
方法：要加删除线的文字左右分别用两个~~号包起来

示例：~~删除线~~

效果：
示例：~~删除线~~

2.4斜体加粗
方法：要倾斜加粗的文字左右分别用三个"*“号或”_"号包起来。

示例1：***斜体加粗***
示例2：**_斜体加粗_**
示例3：___斜体加粗___

效果：
示例1：斜体加粗
示例2：斜体加粗
示例3：斜体加粗

2.5颜色

方法：<font color=color>**自定义内容**</font>

示例1：//绿色，加粗，默认6号字
<font color=green>**自定义内容**</font>

示例2：//红色，加粗，定义4号字
#### <font color=red>**自定义内容**</font>

示例3：//蓝色，加粗，定义3号字
### <font color=blue>**自定义内容**</font>

示例4：//蓝色，不加粗，默认6号字
<font color=blue>自定义内容</font>

效果：
自定义内容

自定义内容

3.引用

3.1单行引用

方法：在引用的文字前加>即可。
示例：> hello world!

效果：

hello world!

3.2多行引用

方法：在引用的每行文字前加>即可。
示例1：
> hello world!
hello world!
hello world!
示例2：
> hello world!
> hello world!
> hello world!

效果：

hello world!
hello world!
hello world!

3.2嵌套引用

方法：在引用的文字前加两个>>、三个>>>、n个...
示例：
>引用的内容
>>引用的内容
>>>引用的内容

引用的内容

引用的内容

引用的内容

4.图片

说明：
1.图片name就是显示在图片下面的文字，相当于对图片内容的解释。
2.图片”标题”是图片的标题，当鼠标移到图片上时显示的内容，可加可不加。
3.如果上传本地图片直接点击导航栏的图片标志，选择图片即可。

4.1图片内链
方法：

方法：
![name](keru./01.png '标题')

4.2图片引用

方法：
![name][01]
[01]: keru./01.png '标题'

4.3图片带有链接

方法：
[![name](keru./01.png '标题')](http://www.baidu.com){:target="_blank"}   
[![name](keru./01.png '标题')][5]{:target="_blank"} 
[5]: http://www.baidu.com

5.列表

5.1无序号列表

方法：用"+"、 "-"、 "*" 任何一种都可以
注意：注意：- + * 跟内容之间都要有一个空格
示例：
- 列表内容
+ 列表内容
* 列表内容

效果：

列表内容

列表内容

列表内容

5.2有序号列表

方法：数字加点
注意：序号跟内容之间要有空格
示例：
1.列表内容
2.列表内容
3.列表内容

效果：
1.列表内容
2.列表内容
3.列表内容

5.3列表嵌套

方法：
1)	上一级和下一级之间敲1个Tab键即可；
2)	*号与后面文字内容要空一格；
3)	"num."(例如：1.)与后面文字内容要空一格；
示例：
* 一级无序号列表内容
	* 二级无序号列表内容
		* 三级无序号列表内容
1. 一级有序列表内容
	2. 二级有序号列表内容
		3. 三级有序号列表内容

效果：

一级无序号列表内容
- 二级无序号列表内容
  - 三级无序号列表内容

一级有序列表内容
1. 二级有序号列表内容
  1. 三级有序号列表内容

5.4任务列表

方法：使用如下的代码创建任务列表，在[]中输入x表示完成，也可以通过点击选择完成。
示例：
- [ ] 上课
- [ ] 放学
- [ ] 回家

效果：

上课
放学
回家

6.表格

6.1MarkDown表格

方法：
|姓名|性别|毕业学校|工资|
|:---|:---:|:---:|---:|
|陈道明|男|AAA大学|15K|
|李小冉|男|BBB大学|18K|
|辛芷蕾|女|CCC大学|20K|
说明：
第二行分割表头和内容；
- 有一个就行，为了对齐，多加了几个；
":"代表文字对齐方式；
1.文字默认居左
2.-两边加：表示文字居中
3.-右边加：表示文字居右
3.-左边加：表示文字居左
注：原生的语法两边都要用 | 包起来。此处省略。

效果：

姓名	性别	毕业学校	工资
陈道明	男	AAA大学	15K
李小冉	男	BBB大学	18K
辛芷蕾	女	CCC大学	20K

6.2html表格
参考：
http://www.tablesgenerator.com/

7.代码

7.1单行代码/内联代码块

方法：代码之间分别用一个反引号包起来
示例：`create database hero;`

效果：
create database hero;

7.2代码块标记

方法：代码之间分别用三个反引号包起来，且两边的反引号单独占一行
示例：
	```
	<div>
	    <div>上课</div>
	    <div>放学</div>
	    <div>回家</div>
	</div>
	```

效果：

<div>
    <div>上课</div>
    <div>放学</div>
    <div>回家</div>
</div>

7.3代码块缩进

方法：开头一个"Tab"键或四个空格

示例：
def setUp(self):
    """
    功能：初始化工作
    :return:
    """

7.4高亮显示

```javascript

8.公式

8.1公式

方法：1个$左对齐，2个$$居中
示例：
$$ x \href{why-equal.html}{=} y^2 + 1 $$

效果：
$\href{why-equal.html}{=} y^2 + 1$

9.脚注

9.1脚注

说明：
[^1]: Markdown是一种纯文本标记语言
示例：
Markdown[^1]

效果：
在这里插入图片描述

10.锚点

注意：只有标题支持锚点， 跳转目录方括号后要有1个空格

10.1公式标题锚点

方法：
[公式标题锚点](#1)
实例：
### [公式标题锚点](#1)

效果：

公式标题锚点

10.1需要跳转的目录

方法：
[需要跳转的目录] {#1}
实例：
### [需要跳转的目录] {#1}

效果：

[需要跳转的目录] {#1}

11.链接

11.1内链

方法：

[超链接名](超链接地址 /"超链接title")
说明：
title可加可不加。
示例：
[百度](http://www.baidu.com/)
[百度](http://www.baidu.com/"百度一下")
[简书](http://jianshu.com)

效果：
百度
 百度
 简书

11.2引用

示例：
[百度][1]
[1]: http://www.baidu.com/"百度一下"

效果：
百度

11.3邮箱

方法：<邮箱号>
示例：
<xxx@outlook.com>

效果：
xxx@outlook.com

11.4URL

方法：<URL>
示例：
<http://www.baidu.com>

效果：
http://www.baidu.com

11.5Html

方法：
<a href="超链接地址" target="_blank">超链接名</a>
示例：
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>
注意：
1.Markdown本身语法不支持链接在新页面中打开，如果想要在新页面中打开的话可以用html语言的a标签代替。
2.有的网站做了处理是可以的（简书）。

效果：
简书

12.表情

12.1表情

方法：将表情代码拷贝过来即可。
表情参考网址：
https://www.webpagefx.com/tools/emoji-cheat-sheet/
示例：
:smile::laughing::blush::smiley::smirk::heart_eyes:

效果：
😄😆😊😃😏😍

13.分割线

13.1分割线

说明：
以下2种方法效果是一样的。
方法1：3个以上的 -
方法2：3个以上的 *
示例：
---
***

效果：

14.流程图

14.1流程图

说明：
	```mermaid
	flowchat                                            #流程
	st=>start: 开始|past:> http://www.baidu.com         #开始，":"后面保持一个空格
	e=>end: 结束                                        #结束
	c1=>condition: 条件1:>http://www.baidu.com[_parent] #判断条件
	c2=>condition: 条件2      #判断条件
	c3=>condition: 条件3      #判断条件
	io=>inputoutput: 输出     #输出
	#----------------以上为定义参数-------------------------
	#----------------以下为连接参数-------------------------
	#开始->判断条件1为no->判断条件2为no->判断条件3为no->输出->结束
	st->c1(yes,right)->c2(yes,right)->c3(yes,right)->io->e
	c1(no)->e                   #条件1不满足->结束
	c2(no)->e                   #条件2不满足->结束
	c3(no)->e                   #条件3不满足->结束
	```

示例：
	```mermaid
	flowchat
	st=>start: 开始|past:> http://www.baidu.com
	e=>end: 结束
	c1=>condition: 条件1:>http://www.baidu.com[_parent]
	c2=>condition: 条件2
	c3=>condition: 条件3
	io=>inputoutput: 输出
	st->c1(yes,right)->c2(yes,right)->c3(yes,right)->io->e
	c1(no)->e
	c2(no)->e
	c3(no)->e
	```

效果：

15.语义标签

15.1斜体
示例：
<i>斜体</i>

效果：
斜体

15.2加粗

示例：
<b>加粗</b>

效果：
加粗

15.3强调

示例：
<em>强调</em>

效果：
强调

15.4上标

示例：
KR<sup>z</sup>

效果：
KR^z

15.5下标

示例：
KR<sub>z</sub>

效果：
KR_z

15.6换行

方法：按下"空格"即可

15.7键盘文本

方法：<kbd>输入键盘文本</kbd>
示例：
<kbd>Ctrl</kbd>
<kbd>Ctrl+ALT</kbd>

效果：
Ctrl
Ctrl+ALT

卢同学.

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Markdown基本语法

一、基本介绍1.概念Markdown是一种纯文本格式的标记语言。通过简单的标记语法可以使普通文本内容具有一定的格式。2.优点1.因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。2.操作简单。3.缺点1.需要记一些语法（比较简单）。2.有些平台不支持Markdown编辑模式。目前支持Markdown编辑模式的有：简书、CSD...
复制链接

扫一扫