Markdown学习笔记

发表于 更新于 阅读次数： 本文字数： 3.4k 阅读时长 ≈ 3 分钟

Markdown介绍

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown图片

Markdown 编写的文档后缀为 .md, .markdown。

Markdown文章编辑

Markdown 标题

使用 # 可标记1-6级标题，一级标题对应一个 # 号，二级标题对应两个# 号，以此类推。

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

Markdown字体

1
2
3
4
5
6
*斜体文字*
_斜体文字_
**粗体文字**
__粗体文字__
***粗斜体文字***
___粗斜体文字___

Markdown 分割线

在一行用三个以上的星号、减号、底线来建立一个分隔线，也可以在其中插入空格。

1
2
3
4
5
6
7
***

* * *

---

- - -

Markdown删除线

在文字的两端加上两个~~ 可以形成删除线效果。例:示例文字 

1
~~文字~~

Markdown下划线

下划线可以通过HTML的<u> 标签实现

1
<u>带下划线文本</u>

显示效果：带下划线文本

脚注

1
2
创建脚注的格式像这样[^脚注]
[^脚注]:脚注概念

显示效果：

创建脚注的格式像这样脚注

Markdown列表

无序列表

无序列表使用* 、+、-作为列表标记，标记后要添加一个空格，然后再填写内容。

1
2
3
4
5
6
7
8
9
10
11
* 示例文字
* 示例文字
* 示例文字

+ 示例文字
+ 示例文字
+ 示例文字

- 示例文字
- 示例文字
- 示例文字

显示效果：

  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字
  • 示例文字

有序文字

有序文字使用数字加上. 来表示

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

显示效果：

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

列表嵌套

列表嵌套只需在子列表选项前添加四个空格

1
2
3
4
5
6
1. 第一项
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

显示效果：

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

区块引用

区块引用是在段落的开头使用> 号，然后在后面加一个空格

1
2
3
> 最外层
>> 第一层嵌套
>>> 第二层嵌套

显示效果：

最外层

第一层嵌套

第二层嵌套

区块中使用列表

1
2
3
4
5
6
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

显示效果：

区块中使用列表

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

列表中使用区块

如果要在列表项目内放进区块，那么就需要在 >前添加四个空格的缩进。

1
2
3
4
* 第一项
    > 示例文字
    > 示例文字
* 第二项

显示效果：

  • 第一项

    示例文字
    示例文字

  • 第二项

Markdown代码

如果是段落上的一个函数或片段可以用反引号将它包起来，例如：

1
`printf()`函数

显示效果：

printf()函数

也可以用```包裹一段代码，并指定一种语言（也可以不指定）：

1
2
3
4
5
```javascript
$(document).ready(function () {
    alert('RUNOOB');
});
​```

显示效果：

1
2
3
$(document).ready(function () {
    alert('RUNOOB');
});

Markdown链接

链接的使用方法如下

1
2
3
4
5
[链接名称](链接地址)

或

<链接地址>

例如：

1
这是一个链接[风速决战的个人博客](https://fsjz2020.github.io/)

显示效果：

这是一个链接风速决战的个人博客

直接使用链接地址

1
<https://fsjz2020.github.io/>

显示效果：

https://fsjz2020.github.io/

Markdown图片

Markdown图片语法格式如下

1
2
3
![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")
  • 开头一个感叹号
  • 接着一个方括号，里面放上图片的替代文字
  • 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。
1
![logo.png](https://fsjz2020.github.io/images/logo.png)

显示效果：

logo.png

Markdown还没有办法指定图片的高度与宽度，如果需要的话，可以使用普通的 标签。

1
<img src="https://fsjz2020.github.io/images/logo.png" width="50%">

显示效果：

Markdown表格

Markdown制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行

1
2
3
4
|表头|表头|
|---|---|
|单元格|单元格|
|单元格|单元格|

显示效果：

表头 表头
单元格 单元格
单元格 单元格

对齐方式

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。
1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示效果：

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

Markdown高级技巧

支持HTML元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：

1
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 打开任务管理器

显示效果：

使用 Ctrl+Alt+Del 打开任务管理器

转义

Markdown支持以下这些符号前面加上反斜杠来插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

公式

当需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

1
2
3
4
5
6
7
8
$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

显示效果：