快速入门 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的标签
带脚注文本,鼠标指一下会显示对应解释[1]

4、Markdown分割线

***

* * *

*****

- - -

----------

效果如下:






5、Markdown 列表项

5.1 Markdown 无序列表

* 文本
* 文本

+ 文本
+ 文本

- 文本
- 文本

效果如下

  • 文本
  • 文本
  • 文本
  • 文本
  • 文本
  • 文本

5.2 Markdown 有序列表

1. 第一项
2. 第二项
3. 第三项

效果如下:

  1. 第一项
  2. 第二项
  3. 第三项

5.3 列表嵌套

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素
  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

6、Markdown区块

> 最外层
>> 第一层嵌套
>>> 第二层嵌套

效果如下:

最外层

第一层嵌套

第二层嵌套

当然,这些是可以互相嵌套的

> 列表
> 1. 第一项
> 2. 第二项
> + 第一项
>> + 第二项
> + 第三项

效果如下:

列表

  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图片

格式是 ![图片名称](图像地址)

如果你是在本地的图片,图像地址就可以用文件路径

如果你需要这个图像到哪儿都可以看,除了把图片的路径改为相对路径然后一并打包,还可以把图像放在图床

效果如下:

atlas

是不是感觉图像太大了?如果你的图像需要缩放,可以使用以下语句

<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}
$$

$$
\begin{Bmatrix}
a & b \\
c & d
\end{Bmatrix}
$$

  • 流程图:
​<pre class="mermaid">graph LR
A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]
​</pre>
graph LR
A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]

文章作者: 拓佑豪
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 拓佑豪 !
评论
  目录