Markdown常用语法

ZeevRitchie

已于 2024-03-22 09:11:37 修改

阅读量1.2k

点赞数 3

文章标签： visual studio code

于 2023-08-15 16:24:41 首次发布

本文链接：https://blog.csdn.net/richargz/article/details/132169564

版权

Markdown常用语法

其他语法操作
- 1.Markdown实现页内跳转的方法

标题

Markdown标题有两种格式标记。
1.使用#号标记
#的个数代表标题的阶数，Markdown中最多只支持六级标题。
语法格式： # + 空格 +标题内容
语法示例：

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

预览效果：
在这里插入图片描述
2.在文本下方使用任意数量的的 == 号来标识一级标题，或用 -- 号来标识二级标题。
语法示例：

一级标题
==
二级标题
---------

预览效果：
在这里插入图片描述注意：使用这种方式，标题上面的内容需要与标题内容隔一行，不不然会出现下面的情况。

段落操作

1.段落
要创建段落，请使用空白行将一行或多行文本进行分隔。
语法示例：

段落一：下面有一空行

段落二：上面有一空行

预览效果：
在这里插入图片描述
2.换行
由于markdown编辑器的不同，换行的操作有点细微的差异，如有的直接 "Enter"回车即可，有些需要在后面加两个空格再回车才行。下面是通用的换行方式：
1.在一行的末尾添加两个或多个空格，然后按回车键；
2.在需要换行的地方加上<br/>。
语法示例：

1.方式一
第一行换行，后面有两个空格  
第二行
2.方式二
第一行换行<br>第二行

预览效果：
在这里插入图片描述
3.首行缩进
使用&emsp;为全角缩进，&ensp;为半角缩进。一个全角缩进相当于缩进了一个中文，想缩进两个字符就放两个。
语法示例：

h首行缩进
&ensp;首行缩进      // 英文是半角
无首行缩进
&emsp;首行缩进      //汉字是全角
&nbsp;首行缩进      //半角的半角

预览效果：
h首行缩进
首行缩进 // 英文是半角
无首行缩进
首行缩进 //汉字是全角
首行缩进 //半角的半角

列表

列表是记笔记时非常基本的功能，Markdown语法支持有序和无序列表，还有任务列表，之间可以交叉使用。
1.有序列表
创建有序列表，就是数字+英文句点的形式，英文句点与后面内容需要隔一个空格。
语法示例：

1. 列表一
2. 列表二

预览效果：
在这里插入图片描述
2.无序列表
在每个列表项前面添加破折号 -、星号* 或加号 + 即可创建无序列表，符号和列表项需要加空格，且缩进一个或多个列表项可创建嵌套列表。
语法示例：

- 无序列表缩进是如何实现的
  * 可以使用Tab键或者空格键进行缩进，但缩进方式最好统一
    + 这三个构建成无序列表的符号可进行替换
* 无序列表符号替换测试
    + 测试无问题
        - 也可只单独使用一种

预览效果：

无序列表缩进是如何实现的
- 可以使用Tab键或者空格键进行缩进，但缩进方式最好统一
  - 这三个构建成无序列表的符号可进行替换

无序列表符号替换测试
- 测试无问题
  - 也可只单独使用一种
    3.任务列表
    任务列表由右破折号-和方括号[ ]构成，并在[ ]前面加上空格，在[ ]里面添加字母X，就是给打上勾了。

语法示例：

- [x] 任务列表创建成功	
	* - [x] 无序列表嵌套使用成功 
- [ ] 1. 有序列表选择，[]中间有一个空格

预览效果：

任务列表创建成功
- - 无序列表嵌套使用成功
1. 有序列表选择，[]中间有一个空格

字体格式

字体操作主要有粗体，斜体，下划线，删除线，字体，颜色功能。
语法示例：

**粗体** 
*斜体* 
_斜体_ 
***粗斜体*** 
~~删除线~~
注：下面的功能使用的是HTML语言编写的，
    Markdown 可算是 HTML 的一个简化了标记形式的子集，部分功能实现需要Markdown编辑器支持修改。
<u>下划线</u>
<font face="黑体">黑体字</font>
<font face="微软雅黑">微软雅黑</font>
<font face="STCAIYUN">华文彩云</font>
<font color=#0099ff size=3 face="黑体">替换的地方</font>
<font color=red>浏览器Size默认3</font>
<font color=#FF8C00 size=6>~~删除线~~</font>

预览效果：
粗体
斜体
斜体
粗斜体
~~删除线~~
下划线
黑体字
微软雅黑
华文彩云
替换的地方
浏览器Size默认3
~~删除线~~

注：color 可用已知颜色名和十六位颜色值来显示需要的颜色，size为文本的尺寸大小，浏览器上的size默认为3。

表格

使用三个或多个连字符-创建每列的标题，可在-两侧加:可以实现左对齐，右对齐或居中。使用管道|分隔每列内容，通过换行可以增加多行列表。
在表格中可以设置文本格式、对其方式等。例如，添加链接，行内式代码，更改字体格式和强调。但是您不能添加标题，列表，代码块引用，水平规则，图像或HTML标签。
可以使用上面的缩进进行表格的长宽，如&emsp; 。
语法示例：

| 第一列：默认| 第二列：左对齐| 第三列：居中| 第四列：右对齐|
|---            | :---      |    :---------:   |          ---: |
| 未做修改 | 链接       | `行内式代码`   |  ***粗体*** |
| Paragraph   | Text        | And more      |   |

注：第二列的---符号可以增减，使得每行每列的符号|不对齐。
预览效果：

第一列：默认	第二列：左对齐	第三列：居中	第四列：右对齐
正常书写	超链接	`行内式代码`	~~粗体删除线~~
图片链接	缩进一个字符	表情 😄

分割线

在空白行上使用三个或多个星号 ***、破折号 ---或下划线 ___ ，符号间不能混合使用，并且不能包含其他内容。为了兼容性，最好在分隔线的前后均添加空白行。
语法示例：

---错误格式，除了符号还有其他内容
***
*********************
---
___

注：第二列的---符号可以增减，使得每行每列的符号|不对齐。
预览效果：
—错误格式，除了符号还有其他内容

引用

在引用的段落文章前加上符号>，跟标题的#用法一样，根据符号的数量进行嵌套操作。
语法示例：

>普通引用
>>>三级嵌套引用
>
>>分段落引用

>* 无符号引用，上面空行表示与上面分隔开
>- [x] 任务事件，等等，可进行组合使用  :family:

预览效果：

普通引用

三级嵌套引用

分段落引用

无符号引用，上面空行表示与上面分隔开

任务事件，等等，可进行组合使用 👪

代码

代码格式主要有两种，行内代码和代码块形式。行内代码是用反引号``将需要文字包裹起来，不是单引号'，位置在键盘Esc下面。代码块可以用文本缩进和围栏式代码块形式形成，围栏式代码块形式可以使用代码高光。
语法示例：

这句话使用了`行内代码`的操作

	#include <stdio.h>                         //利用缩进进行代码编写，上面需要空行
	int main()
	{
	    printf("Hello, World! \n");
	    return 0;
	}
围栏式代码块
```
1.整块代码编写
	int main
	{
		printf("Hello World");
	}
```
```java
2.在 ```后面指定语言
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World");
    }
}
```

预览效果：
这句话使用了行内代码的操作

#include <stdio.h>                         //利用缩进进行代码编写
int main()
{
    printf("Hello, World! \n");
    return 0;
}

围栏式代码块

1.整块代码编写
	int main
	{
		printf("Hello World");
	}

2.在 ```后面指定语言
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World");
    }
}

链接

链接可以帮助我们快速跳转到想要了解的内容或者网页，使阅读时更加的方便。
1.超链接
超链接的显示名可以使用上面的字体格式进行修改，而超链接title是可选的，它的功能是当你鼠标放到超链接名上面时，会显示你所要展示的文字，超链接title包裹的符号可以使用"或 '或( )。
语法格式：

1.[超链接显示名](超链接地址）
2.[超链接显示名](超链接地址 "超链接title")   --- 符号"可使用'或者()替代，且title与前面的地址需要空格隔开
3.<超链接地址>

语法示例：

[百度](https://www.baidu.com/)
[百度](https://www.baidu.com/ "有事问度娘") --- 鼠标放上去试试
<https://www.baidu.com/>
***[百度](https://www.baidu.com/ "有事问度娘") ***
**[百度](https://www.baidu.com/ "有事问度娘")**

预览效果：
百度
 百度 — 鼠标放上去试试
https://www.baidu.com/
百度
2.引用链接
引用链接是一种特殊的链接，它使URL(“网址”)在Markdown中更易于显示和阅读。参考样式链接分为两部分：与文本保持内联的部分以及存储在文件中其他位置的部分，以使文本易于阅读。引用链接的第二部分放在Markdown文档中的任何位置。
语法格式：

第一部分：[链接文字][链接id]         /*id不局限于数字，但是两个部分的ID要相同*/
第二部分： [链接id]: 真正的链接URL "可选的title"
注：第一部分和第二部分需要空一行

语法示例：

[CSND博客][1]

[1]: https://blog.csdn.net/RichargZ?spm=1011.2415.3001.5343
[百度][Running]

[Running]: https://www.baidu.com/

预览效果：

CSND博客

百度

图片

图片可以导入本地图片，也可以插入网络上的图片，其中互联网上的图片可以用上面的链接方式进行操作，当点击文本就跳转到那个图片。
语法格式：

/*图片地址包括`本地地址`和`互联网地址`*/
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
本地地址：
!["图片说明"](“文件夹”/"图片名称")

语法示例：

![CSDN图标](https://csdnimg.cn/cdn/content-toolbar/csdn-logo_.png?v=20190924.1)
![CSDN图标](https://csdnimg.cn/cdn/content-toolbar/csdn-logo_.png?v=20190924.1 "CSDN图标")

预览效果：
CSDN图标

脚注

脚注能对文章中的内容进行具体说明且不会影响文章的美观度，脚注的内容会自动在文章末端。
语法格式：

/*标识符可以是数字或单词，但不能包含空格或制表符。*/
第一部分：[文本][^标识符]         
第二部分： [^标识符]: 脚注的内容，对文本的具体说明

语法示例：

学习[^6] 和 游戏[^Running] 如何平衡
[^6]: 学习的过程是枯燥的，咬咬牙就过去了
[^Running]: 学完后玩一把游戏，太爽了

预览效果：
学习¹ 和游戏² 如何平衡

表情

表情的使用，能够使得文章看起来有些俏皮，整体的阅读会增添一些风趣。语法是以冒号:开头和结尾，中间输入表情的英文单词，全小写。具体的表情对应的英语词语在表情网站可以找到📖😄 但是否能使用需要看当下的Markdown编译器是否支持。

语法示例：

:family: :older_man: :cry:

预览效果：
👪 👴 😢

其他语法操作

1.Markdown实现页内跳转的方法

跳转语法有两个部分组成，跳转的起点和终点。定义一个锚，即跳转的终点，然后调用[跳转文本] (#跳转标志)语法格式跳到指定位置，主要是跳转标志，两个部分必须要相同，第二部分的跳转文本都可删除。实例
语法格式：

 第一部分：[跳转文本](#跳转标志)
 
第二部分：<div id = "跳转标志">跳转文本<div>

语法示例：

 [实例](#jump)

<div id = "jump">实例<div>

预览效果： 跳转起点在开头

实例

总结：以上是笔者用到过的Markdown语法，总结出来用于抛砖引玉，欢迎各位大佬来评论区留言

学习的过程是枯燥的，咬咬牙就过去了 ↩︎
学完后玩一把游戏，太爽了 ↩︎