前言
总目录
MarkDown是一种轻量级的语言,由于易写易读的特性,越来越被程序员们所喜爱,下面我就介绍一下MarkDown的用法吧。
1.MarkDown概述
1.基本信息
Markdown 是一种轻量级标记语言,为约翰·格鲁伯(John Gruber)在2004年创造。 这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式,并选择性的转换成有效的XHTML(或是HTML)”,MarkDown文件的后缀名为 .md,.markdown。
2.优点
(1)轻量,简洁
(2)易写易读,提高编写文档效率
(3)MarkDown编写的文档可导出多种格式,如PDF,HTML,图片等等
3、常用MarkDown编辑器
Typora,VSCode,Obsidian,MarkdownPad,Haroopad…等等,编辑器种类繁多,用的顺手即可。
二、MarkDown基本语法
1.标题
使用#号标记,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推,一共有六级标题。
# 一级标题
## 二级标题.......
依次类推
注意:# 和标题之间需要有一个空格
2.文本样式
(1)斜体加粗
斜体文字,可用一对*或_将文字包裹住。
加粗文字,用两对*或_将文字包裹住。
斜体加粗,用三对*或_将文字包裹住。
*斜体文字*
**加粗文字**
***斜体加粗***
效果如下:斜体文字,加粗文字,斜体加粗
(2)删除线
使用~~将需要删除线的文字包裹住,如
~~删除文本~~
效果如:删除文本
(3)下划线
使用HTML中的标签u,如
<u>下划线文本</u>
效果如:下划线文本
(4)引用文本
使用> 后面 加一个空格 然后写文本,如
> 引用文本
效果如:
引用文本
双层引用:一层引用加一个>
> 第一层引用
>> 第二层引用
>>> 第三层引用
效果如下:
第一层引用
第二层引用
第三层引用
(5)注脚
一个具有注脚的文本。[^注脚]
[^注脚]:这里写解释性文字
效果如:一个具有注脚的文本。1
注脚是一对的,第一行表示标注,第二行表示标注的解释
(5)分隔符
使用三个“-” 则可以形成分隔符
如我们使用---
时,效果如下:
3.列表
(1)列表用 - 后面一个空格 就是列表(当然使用 + 或* 替换_都是可以的)
- 列表项1
- 列表项2
效果如下:
- 列表项1
- 列表项2
(2)列表项内套用列表项,只需在子列表前按下Tab/或者打4个空格,然后使用 - 加一个空格
- 列表项1
- 子列表项1
- 子列表项2
- 列表项2
效果如下:
- 列表项1
- 子列表项1
- 子列表项2
- 列表项2
(3)列表项,标注完成状态
- [] 计划任务,注意[ ]中需要有一个空格,文字和中括号之间也需要有个空格
- [x] 完成任务
效果如下:
- 计划任务,注意[ ]中需要有一个空格,文字和中括号之间也需要有个空格
- 完成任务
4.超链接
使用[]+()的方式表示超链接,用法如下:
[总目录](https://blog.csdn.net/qq_39847278/article/details/127617179)
中括号内放需要链接的内容,小括号内放链接地址,效果如:总目录,鼠标点击即可跳转。
5.图片
格式:![alt 属性文本](图片地址)
![Alt](https://img-home.csdnimg.cn/images/20220524100510.png)
6.表格
使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
设置表格的对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
效果如下:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
7.代码片
如果是段落上的一个函数或片段的代码可以用反引号把它包起来(` ),例如:
printf()
函数
可以用 ```包裹一段代码,并指定一种语言(也可以不指定)
```csharp
Console.Write(“”);
Console.ReadLine();
```
效果如下:
Console.Write("");
Console.ReadLine();
8.目录
使用[TOC]即可生成目录
二、进阶用法
1.支持的 HTML 元素,常用<kbd> 和</br>
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
效果如下:
使用 Ctrl+Alt+Del 重启电脑
如:
<b>你好</b><br/><sub>女士们<sub/>,<sup> 乡亲们</sup> ~
效果如下:
你好
女士们, 乡亲们 ~
2.转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符
**文本加粗**
\*\* 正常显示星号 \*\*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+加号
- 减号
. 英文句点
! 感叹号
3.各类公式与流程图
日常使用不多,对于这种可以直接通过图片解决,如果需要自己研究,详情可查:
LaTex数学公式
甘特图
UML图
Flowchart流程图
案例:
Gamma公式展示
Γ
(
n
)
=
(
n
−
1
)
!
∀
n
∈
N
\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N
Γ(n)=(n−1)!∀n∈N 是通过 Euler integral
Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.
总结
总目录
以上就是今天要讲的内容,本文介绍MarkDown的基本语法,希望以上内容可以帮助到大家,如果不对之处,还请批评指正。
参考文档:https://www.runoob.com/markdown/md-tutorial.html
这里写解释性文字 ↩︎