快速学习Markdown(新手向)
快速学习Markdown
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。
本篇可能是目录结构最混乱的文章,跟紧带序号的标题,开始学习吧 ☀️ )
1、Markdown 应用
Markdown 能被使用来撰写电子书,如:Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
本教程使用的是Typora
。用vscode也是可以的,在vscode右侧栏扩展按钮下载Markdown Preview Enhanced 即可。
在Typora
,用ctrl + /
按键即可切换源码模式和预览模式。
2、Markdown 标题
2.1 我是一级标题
=================
2.2 我是二级标题
-----------------
效果如下
2.1 我是一级标题
2.2 我是二级标题
用#号标记六级标题,参考如下效果
# 2.3 一级标题
## 2.4 二级标题
### 2.5 三级标题
#### 2.6 四级标题
##### 2.7 五级标题
###### 2.8 六级标题
2.3 一级标题
2.4 二级标题
2.5 三级标题
2.6 四级标题
2.7 五级标题
2.8 六级标题
3、Markdown字体
markdown可以使用一下几种字体,参考如下效果:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
~~删除线文本~~
<u>带下划线文本</u> #通过HTML的<u></u>标签
带脚注文本,鼠标指一下会显示对应解释 [^tuoyou-hao]。
[^tuoyou-hao]: 拓佑豪博客
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
删除线文本
带下划线文本 #通过HTML的标签
带脚注文本,鼠标指一下会显示对应解释{% ref t%}。
{% references hide %}
[t] 拓佑豪博客
4、Markdown分割线
***
* * *
*****
- - -
----------
效果如下:
5、Markdown 列表项
5.1 Markdown 无序列表
* 文本
* 文本
+ 文本
+ 文本
- 文本
- 文本
效果如下
- 文本
- 文本
- 文本
- 文本
- 文本
- 文本
5.2 Markdown 有序列表
1. 第一项
2. 第二项
3. 第三项
效果如下:
- 第一项
- 第二项
- 第三项
5.3 列表嵌套
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
6、Markdown区块
> 最外层
>> 第一层嵌套
>>> 第二层嵌套
效果如下:
最外层
第一层嵌套
第二层嵌套
当然,这些是可以互相嵌套的
> 列表
> 1. 第一项
> 2. 第二项
> + 第一项
>> + 第二项
> + 第三项
效果如下:
列表
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
7、Markdown 代码
单行代码:
`echo HelloWorld`
效果如下:
echo HelloWorld
代码区块:
```c
#include <stdio.h>
void main(){
printf("Hello World\n");
}//a.c
```
你可以在第一行的```
旁边指定语言,也可以不指定。效果如下
#include <stdio.h>
void main(){
printf("Hello World\n");
}//a.c
8、Markdown 链接
这是一个链接 [拓佑豪的博客](tuoyou-hao.github.io)
效果如下:
这是一个链接 拓佑豪的博客
在Typora,也可以直接打链接地址:https://tuoyou-hao.github.io
高级链接
这个链接用 1 作为网址变量 [baidu][1]
然后在文档的结尾为变量赋值(网址)
[1]: https://www.baidu.com/
效果如下:
这个链接用 1 作为网址变量 baidu
然后在文档的结尾为变量赋值(网址)
9、Markdown图片
格式是 ![图片名称](图像地址)
如果你是在本地的图片,图像地址就可以用文件路径
如果你需要这个图像到哪儿都可以看,除了把图片的路径改为相对路径
然后一并打包,还可以把图像放在图床
效果如下:
是不是感觉图像太大了?如果你的图像需要缩放,可以使用以下语句
<img src=图片地址 style="zoom: 缩放比例;" />
<img src="https://support.huaweicloud.com/productdesc-Atlas200DK1012/figure/zh-cn_image_0205566091.png" style="zoom: 33%;" />
10、Markdown表格
Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
效果如下:
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
文字对齐方式:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
11、Markdown其他技巧
1、支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:kbd、b、i、em、sup 、ub、br
等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>c</kbd> 键复制文本
使用 Ctrl+c 复制文本
2、转义
Markdown 使用了很多特殊符号来表示不同的符号,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
**文本加粗**
\*\* 正常显示星号 \*\*
文本加粗
** 正常显示星号 **
Markdown 支持在这些符号前面加上反斜杠,达到转义的目的:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
3、Markdown表情
可以使用各种emoji,🔆或者💡等等都可以
想要使用这些emoji,可以前往这个链接emoji,找到合适的emoji,点击一下就复制成功了,可以自由使用在Markdown里。
4、数学公式、流程图等等
markdown支持书写数学公式,代码建立流程图等等,后续会出专栏专门介绍。
- Latex数学矩阵表示:
$$
\begin{Bmatrix}
a & b \\\\
c & d
\end{Bmatrix}
$$
- 流程图:
```mermaid
graph LR
A[方形] -->B(圆角)
B --> C{条件a}
C -->|a=1| D[结果1]
C -->|a=2| E[结果2]
F[横向流程图]
```