Markdown 语法说明

读书是最有意思的旅行方式

2023-02-01 Viewed Times

总览

本文收集了Markdown的语法信息,然后制作成了速查表,提供了所有 Markdown 语法元素的基本解释。
如果你想了解某些语法元素的更多信息,请参阅更详细的 基本语法 和 扩展语法

基本语法

标题

不同数量的#可以完成不同的标题,如下:

1
2
3
4
5
# 一级标题

## 二级标题

### 三级标题

字体

粗体、斜体、粗体和斜体,删除线,需要在文字前后加不同的标记符号。如下:

1
**这个是粗体**

这个是粗体

1
*这个是斜体*

这个是斜体

***这个是粗体加斜体***

这个是粗体加斜体

~这里想用删除线~~

~这里想用删除线~~

注:如果想给字体换颜色、字体或者居中显示,需要使用内嵌HTML来实现。

无序列表

无序列表的使用,在符号-后加空格使用。如下:

1
2
3
- 无序列表 1
- 无序列表 2
- 无序列表 3
  • 无序列表 1
  • 无序列表 2
  • 无序列表 3

如果要控制列表的层级,则需要在符号-前使用空格。如下:

1
2
3
4
- 无序列表 1
- 无序列表 2
- 无序列表 2.1
- 无序列表 2.2
  • 无序列表 1
  • 无序列表 2
    • 无序列表 2.1
    • 无序列表 2.2

有序列表

有序列表的使用,在数字及符号.后加空格后输入内容,如下:

1
2
3
1. 有序列表 1
2. 有序列表 2
3. 有序列表 3
  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3

引用

引用的格式是在符号>后面书写文字。如下:

1
2
3
> 读一本好书,就是在和高尚的人谈话。 ——歌德

> 雇用制度对工人不利,但工人根本无力摆脱这个制度。 ——阮一峰

读一本好书,就是在和高尚的人谈话。 ——歌德

雇用制度对工人不利,但工人根本无力摆脱这个制度。 ——阮一峰

链接

1
[你是《未来世界的幸存者》么?](https://mp.weixin.qq.com/s/s5IhxV2ooX3JN_X416nidA)

你是《未来世界的幸存者》么?

图片

插入图片,格式如下:

![这里写图片描述](/img/header_img/lml_bg.jpg)

这里写图片描述

分割线

可以在一行中用三个以上的减号来建立一个分隔线,同时需要在分隔线的上面空一行。如下:

---


表格

可以使用冒号来定义表格的对齐方式,如下:

1
2
3
4
5
| 姓名   | 年龄 |     工作 |
| :----- | :--: | -------: |
| 小可爱 | 18 | 吃可爱多 |
| 小小勇敢 | 20 | 爬棵勇敢树 |
| 小小小机智 | 22 | 看一本机智书 |
姓名 年龄 工作
小可爱 18 吃可爱多
小小勇敢 20 爬棵勇敢树
小小小机智 22 看一本机智书

特殊语法

脚注

脚注与链接的区别如下所示:

1
2
链接:[文字](链接)
脚注:[文字](脚注解释 "脚注名字")

有人认为在[大前端时代](https://en.wikipedia.org/wiki/Front-end_web_development "Front-end web development")的背景下,移动端开发(Android、IOS)将逐步退出历史舞台。

有人认为在大前端时代的背景下,移动端开发(Android、IOS)将逐步退出历史舞台。

[全栈工程师](是指掌握多种技能,并能利用多种技能独立完成产品的人。 "什么是全栈工程师")在业务开发流程中起到了至关重要的作用。

全栈工程师在业务开发流程中起到了至关重要的作用。

脚注内容请拉到最下面观看。

代码块

如果在一个行内需要引用代码,只要用反引号引起来就好,如下:

Use the \`printf()\` function.

Use the printf() function.

在需要高亮的代码块的前一行及后一行使用三个反引号,同时第一行反引号后面表示代码块所使用的语言,如下:

\```java // FileName: HelloWorld.java public class HelloWorld { // Java 入口程序,程序从此入口 public static void main(String[] args) { System.out.println("Hello,World!"); // 向控制台打印一条语句 } } \```
1
2
3
4
5
6
7
// FileName: HelloWorld.java
public class HelloWorld {
// Java 入口程序,程序从此入口
public static void main(String[] args) {
System.out.println("Hello,World!"); // 向控制台打印一条语句
}
}

支持以下语言种类:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
bash
clojure,cpp,cs,css
dart,dockerfile, diff
erlang
go,gradle,groovy
haskell
java,javascript,json,julia
kotlin
lisp,lua
makefile,markdown,matlab
objectivec
perl,php,python
r,ruby,rust
scala,shell,sql,swift
tex,typescript
verilog,vhdl
xml
yaml

如果想要更换代码高亮样式,可在上方代码主题中挑选。

其中微信代码主题与微信官方一致,有以下注意事项:

  • 带行号且不换行,代码大小与官方一致
  • 需要在代码块处标志语言,否则无法高亮
  • 粘贴到公众号后,用鼠标点代码块内外一次,完成高亮

diff 不能同时和其他语言的高亮同时显示,且需要调整代码主题为微信代码主题以外的代码主题才能看到 diff 效果,使用效果如下:

1
2
+ 新增项
- 删除项

其他主题不带行号,可自定义是否换行,代码大小与当前编辑器一致

数学公式

行内公式使用方法,比如这个化学公式:$\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}$

块公式使用方法如下:

$$H(D_2) = -\left(\frac{2}{4}\log_2 \frac{2}{4} + \frac{2}{4}\log_2 \frac{2}{4}\right) = 1$$

矩阵:

1
2
3
4
5
6
7
8
$$
\begin{pmatrix}
1 & a_1 & a_1^2 & \cdots & a_1^n \\
1 & a_2 & a_2^2 & \cdots & a_2^n \\
\vdots & \vdots & \vdots & \ddots & \vdots \\
1 & a_m & a_m^2 & \cdots & a_m^n \\
\end{pmatrix}
$$

公式由于微信不支持,目前的解决方案是转成 svg 放到微信中,无需调整,矢量不失真。

目前测试如果公式量过大,在 Chrome 下会存在粘贴后无响应,但是在 Firefox 中始终能够成功。


如果您喜欢此博客或发现它对您有用,则欢迎对此发表评论。 也欢迎您共享此博客,以便更多人可以参与。 如果博客中使用的图像侵犯了您的版权,请与作者联系以将其删除。 谢谢 !