Markdown基本语法笔记

markdown 基本语法笔记

基本语法
标题语法
段落语法
换行语法
强调语法
引用语法
- 单个段落引用
- 多个段落引用
- 引用的嵌套
- 引用中可包含其他元素
- - 这是一个四级标题
列表语法
- 有序列表
- 无序列表
代码语法
分割线语法
链接语法
图片语法
转义字符语法

摘自Markdown官方教程

基本语法

Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。

在线体验在线markdown编辑器

Markdown的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握，而就是这十个不到的标记符号，却能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。

标题语法

要创建标题，在单词或短语前面添加井号（#）。#号的数量代表了标题的级别。为了兼容考虑，用一个空格在#和标题之间进行分隔

段落语法

创建段落，使用空白行将一行或多行文本进行分隔

换行语法

在一行的末尾添加两个或者多个空格，然后按回车键，即可创建一个换行。或者添加HTML标签“<br>”也可换行。（换行在宇宙第一编辑器vscode中，单击enter键会自动识别为换行，但是在mac版vscode中则需要添加空格后换行）

强调语法

markdown的强调语法仅包含斜体和粗体。

粗体（Bold）使用两个星号（**）或两个下划线（__）将文本包含起来即可。如**这是粗体文本**或者__这是粗体文本__会被渲染为这是粗体文本
斜体（Italic）使用一个星号（*）或一个下划线（_）将文本包含起来即可。如*这是斜体文本*或者_这是斜体文本_会被渲染为这是斜体文本

引用语法

单个段落引用

创建引用，在段落之前添加一个>符号即可。如">这是一段引用"会被渲染为

这个是一段引用

多个段落引用

多个段落的引用需要在段落之间的空白行添加>符号。
如

>第一个段落的引用
>
>第二个段落的引用

会被渲染为:

第一个段落的引用

第二个段落的引用

引用的嵌套

引用可进行嵌套，在要嵌套的段落前添加一个>>符号。
如

>第一级引用
>
>>第二级引用
>
>>>第三级引用

会被渲染为：

第一级引用

第二级引用

第三级引用

引用中可包含其他元素

在引用中可以包含其他markdown格式的元素。but并非所有元素都可以使用，需要实践。

如

> #### 这是一个四级标题
> - 无序列表
> 1. 有序列表
> *斜体* **粗体**
> ...

会被渲染为：

这是一个四级标题

无序列表

有序列表
斜体粗体
…

列表语法

有序列表

在每个列表项前添加数字（该数字不需要安装序号顺序）并紧跟一个英文句号和一个空格。

如

1.第一个列表项
1.第一个列表项
1.第一个列表项
或者
1.第一个列表项
2.第一个列表项
3.第一个列表项
或者
1.第一个列表项
3.第一个列表项
88.第一个列表项

都会被渲染为:

第一个列表项
第一个列表项
第一个列表项

列表的嵌套：

1. 第一个列表项1. 第一个列表项子项12. 第一个列表项子项2
2. 第二个列表项

第一个列表项
1. 第一个列表项子项1
2. 第一个列表项子项2
第二个列表项

无序列表

在每个列表项前面添加一个破折号（-）、星号（*）或者加号(+)。缩进一个或多个列表项可创建嵌套列表。

如

- 无序列表
- 无序列表
* 无序列表
* 无序列表
+ 无序列表
+ 无序列表

均被渲染为

无序列表
无序列表

- 无序列表- 无序列表子项 - 无序列表子项- 无序列表子项的子项- 最多四级啦
- 无序列表

无序列表
- 无序列表子项
- 无序列表子项
  - 无序列表子项的子项
    - 最多四级啦
无序列表

代码语法

单词或短语将其包含在（`）中，代码块则包含在（```）中，并写上代码的类型，如（```html）。

<!DOCTYPE html>
<html>
  <head>
    <meta charset=“UTF-8”>
    <title>这是一个HTML5的网页
  </head>
  <body>
    <p>Hello HTML5</p>
  </body>
</html>

渲染为：

<!DOCTYPE html>
<html><head><meta charset="UTF-8"><title>这是一个HTML5的网页</title></head><body><p>Hello HTML5</p></body>
</html>

分割线语法

跟word创建分割线类似，使用三个或多个(***)、破折号（---）或下划线（___），不能包含其他内容。

***
---
___
******

链接语法

链接的文本放在中括号（[]）中，链接地址放在紧挨在中括号后的括号中，链接的title可选。[超链接显示的文本](超链接地址 "超链接的title属性")。
超链接显示的文本，鼠标移到此处显示超链接的title，点击跳转到超链接地址

图片语法

添加图片格式：![图片alt文本](图片链接 "图片的title属性")

![这是一张在线的图片，图片无法加载时会显示该文本](https://img-blog.csdnimg.cn/4078d8d2161d4dc6aaab8fe2e5843a75.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LiA5Y-q5pyI5pyI6bif5ZGA,size_20,color_FFFFFF,t_70,g_se,x_16 "图片的title属性，鼠标移入显示")
![这是一张在线的图片，图片无法加载时会显示该文本](httpGA,size_20,color_FFFFFF,t_70,g_se,x_6 "图片的title属性，鼠标移入显示")

转义字符语法

在我们正文中需要使用到markdown的关键字时，可在前面加一个\符号，即可转义该字符。在使用到markdown关键字的时机加上\符号即可，如"`“就需要写为”\`"