Markdown语法使用和个人总结

一. Html与Markdown

• Html是超文本标记语言，目前Html5是主流标准。
• Markdown是超轻量级标记语言，它是完全支持Html语法，可以直接使用html标签。
• Markdown是主要用于写文档，默认的Markdown语法写出来的文档效果还不是很丰富，所以有的Markdown编辑器对其进行扩展，使其支持公式、视频等。当然我们也可以自己使用html标签达到同样效果。

---

二. Markdown语法演示和注意事项

1. 标题

语法 #+空格+标题内容

• 在行首插入 # 才有效
• # 个数表示标题的等级，有1-6级标题，对应html中h1-h6
• 注意事项:# 和标题内容之间一定有空格，空格至少一个，否则当成普通文本

源码

# 一级标题
## 二级标题
### 三级标题

效果

一级标题

二级标题

三级标题

---

2. 分割线

语法 ---

• 在行首插入 - 才有效
• - 个数不能少于3个，一般与上一行文字长度对齐，这样Markdown文档显得好看
• 注意事项:—- 和上一行建议 至少隔一行 ，若上一行是普通文本，下一行是分割线则翻译成 二级标题。

源码

分割线
-----
分割线
-----

效果

分割线

分割线

---

注意 上面分割线与普通文本之间 隔行和没隔行 的区别

---

3. 列表

语法

• 在行首写才有效
• 有序列表: 1.+空格+内容，2.+空格+内容，…。注意 数字后而只能是点，不能是顿号。
• 无序列表: -/+/*+空格+内容,无序列表符号有3个，任意一个都可以
• 下一级: 无序列表 要在前面加上2个空格，若是在引用块中则要4个空格。有序列表 要用另一种计数方式
• 有序列表序号: 若是0.则表示从上行自动计算，若是小于或等于上一行也自动计算

源码

1. 前端部分
(1). html
(2). css
2. PHP编程
2-1. 基础语法
2-2. 全局变量
0. 综合实战
-------------
- 前端部分
  - html
  - css
- PHP编程
  + 基础语法
  + 全局变量
- 综合实战

效果

1. 前端部分
   (1). html
   (2). css
2. PHP编程
   2-1. 基础语法
   2-2. 全局变量
3. 综合实战

• 前端部分
  • html
  • css
• PHP编程
  • 基础语法
  • 全局变量
• 综合实战

---

4. 引用

语法 行引用是:>+空格+内容，行内引用是:`+内容+`

• 行引用要在行首才有效，行内引用在行内任何位置都可以

源码

>我是一行引用  
这里演示`行内引用`

效果

我是一行引用

这里演示 行内引用

---

5. 代码块

语法

• 单行代码同行内引用一样，都是 `+内容+`
• 多行代码块则```+(换行)+内容+(换行)+```,可以指定代码类型，如html、php和shell等，则自动高亮显示对应语法的关键字。

源码

单行代码块:`<script>console.log('Hello World!');</script>`
多行代码块(这里省略多行代码块标签):
$name='woxiaoyao';
echo $name;

效果

<script>console.log('Hello World!');</script>

$name='woxiaoyao';
echo $name;

---

6. 链接

语法

• 只显示链接文本: [内容](地址+空格+提示),提示可以不写
• 全显示: [内容](地址)<地址>
• 只显示链接: 内容<地址>

代码

[PHP中文网](https://www.php.cn 'PHP爱好者聚集乐园')
[PHP中文网](https://www.php.cn 'PHP爱好者聚集乐园')<https://www.php.cn>
PHP中文网<https://www.php.cn>

效果

PHP中文网
PHP中文网https://www.php.cn
PHP中文网https://www.php.cn

---

7.图片

语法

图片语法就是在链接语法前面加上感叹号！

代码

![十三期前端开发](https://s1.ax1x.com/2020/10/19/0ve4zV.png '前端开发')

效果

---

8.表格

语法

• 表格由 |和- 画出，其中|表示竖向分割线，-表示横向分割线
• 表格由 表头+表格式+表内容 组成，表格式使用 冒号: 可以指定左、中、右对齐
• 表格更复杂操作、如颜色、列宽、合并等则需要html标签table来实现了

代码

|序号|内容|时间|讲师|            **表头**
|:-:|---|---|----:|            **表格式**
|1|前端开发|5周|朱老师|         **表内容**
|2|PHP编程|4周|朱老师|
|3|综合实战|5周|灭绝/西门|

效果

序号	内容	时间	讲师
1	前端开发	5周	朱老师
2	PHP编程	4周	朱老师
3	综合实战	5周	灭绝/西门

三、个人总结

语法标签分类

• 单个标签: 如标题#、引用>、有序列表和无序列表等。
  +标签在 行首 才有效
  +标签和内容之间有 空格，引用>和内容之间有无空格均可以

• 成对标签: 如引用``，代码块```,强调 ，斜体*等。
  +标签和内容之间一般 不用空格
  +标签与外部文本之间 要有空格**

• 复合标签: 如链接 []()<> ,图上 ![]()，表格等
  +标签与内容之间不需要空格

• 生成目录 使用[toc]即可

几个特殊符

• 1个空格: 常用于语法标签与普通文本的分隔、链接或图片中提示文本与地址之间
• 2个空格: 如行内换行时需要两个空格+回车，无序列表下一级前面有空格
• 空行 建议不同语法标签之间要用空行分隔，否则易出现想不到效果