markdown语法备忘

区块元素

段落和换行

段落由一个或多个连续的文本行组成,它的前后要有一个以上的空行
普通段落不该用空格或制表符来缩进。

注:插入<br/>强制换行,但仍旧属于同一段落。有些支持回车,有些则不支持

  强制缩进可以使用四个 &nbsp; 或者两个 &emsp;

标题

类 Setext:利用 = 与 - ,至少两个。

类 Setext
------

类 Atx 形式:行首(必须)插入 1 到 6 个 # ,标题文字前加空格,闭合后更美观

## 这是 H2
## 这是 H2 ##


区块引用

使用 > ,可以嵌套

引用的区块内可以使用其他的 Markdown 语法

引用的最后空一行(回车)


列表

无序列表 标记: * 、+ 、- 加空格,可混用,非第一项可以使用有序列表标记

有序列表 标记:第一项必须数字 + 英文句点,可无序,非第一项可使用 * + -

复选列表 标记:* 、+ 、- 加空格,加[],加空格,方括号内用空格代表未选中,x代表选中

列表标记最多可缩进3个空格,标记后面必须至少一个空格或制表符

可嵌套,但属于子项的标记符号应相对于其父标记缩进

项目内可使用 段落区块引用,留心项目间的空行


表格

使用 |、- 、:三个符号,第一个用于限定范围,第二个分割表头,最后一个用于指定居中形式:

| head1 | head2 | head3 |
| ----- | ----: | :—: |
| sth | sth | sth |
| sth | sth | sth |

head1 head2 head3
sth sth sth
sth sth sth

代码区块

缩进 4 个 空格 或是 1 个 制表符

前面必须空一行,并且在代码区块中,Markdown 语法不会被转换

coding here

在vscode中的代码高亮与显示行数:(待补充)

分隔线

一行中使用三个以上的 * 、- 、_ 来建立一个分隔线

行内可有空格,建议使用下划线


区段元素

链接

行内式 的链接:[Key](LinkPath "Option Title")

参考式 的链接:[Key][id] (另起它行) [id]: LinkPath "Option Title"

隐式链接[Key][] (另起它行) [Key]: LinkPath "Option Title"
[Key][]

id不区分大小写,位置任意;Title不限于使用双引号,还可以单引、括号

链接网址可以用 <> 限定


强调

使用 * 或 _ :

斜体 强调: *被强调的文字* 被强调的文字

粗体 强调:**被强调的文字** 被强调的文字

粗体+斜体 强调:***被强调的文字*** 被强调的文字

删除线:这是一段~~加删除线的文本~~. 这是一段加删除线的文本.

下划线:<u>下划线</u>下划线


代码

标记一小段***行内代码*** :用反引号(`)包起来

在代码区段内插入反引号:多个反引号来开启和结束代码区段

`` 插入个单引号:` ``

代码区段内的 & 和 < 都会被自动地转成 HTML 实体


图片

与链接方式相似,但要在非定义的 [Key] 前加“!”

不同的是,Key不会被显示,但Title会被显示

只能插入图片,但不能设置宽度

到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的<img>标签。


其它

自动链接:只要是用 <> 包起来, Markdown 就会自动把它转成链接。

附注

1
2
3
附注[^1]内容

[^1]:https://x-zeppelin.github.io/

附注[1]内容

插入LaTeX

在markdown中可以和LaTeX一样使用数学语法

行内公式:$\varepsilon\propto v^2$:

εv2;\varepsilon\propto v^2;

行间公式:

1
2
3
4
5
6
$$
\begin{cases}
mu_1+Mv_1=-mu+Mv\\
mu_1^2/2+Mv_1^2/2=MV^2/2 \tag{3}
\end{cases}
$$

{mu1+Mv1=mu+Mvmu12/2+Mv12/2=MV2/2(3)\begin{cases} mu_1+Mv_1=-mu+Mv\\ mu_1^2/2+Mv_1^2/2=MV^2/2 \tag{3} \end{cases}

灵活使用html

markdown支持的格式有限,所以为了灵活使用一些格式,我们可以借助html实现一些扩展功能

注释 (typora不支持)

<!-- 这是注释 -->

图片 <img>

可以设置文件大小等参数

<img  src=./picture/a.jpg height="100px" style>

居中<center> </center>

<center> 居中显示的字体</center>
居中显示的字体

unicode字符

参考菜鸟教程
Unicode 字符百科

字符 编号 实体 描述
© &#169; &copy; 版权所有(REGISTERED SIGN)
&#9312; 圈1

CSS

注:在html中可以使用markdown语法,但必须另起一行

1
2
3
<div style="font-size: 20px; color: steelblue;text-align:center">
hello ***world***
</div>
hello ***world***
  1. (typora不支持)
1
2
3
4
5
6
7
<style type="text/css">
qwq{
font-size: 15px;
color: red;
}
</style>
<qwq>aaa</qwq>

aaa

  1. (typora不支持)
1
2
3
4
5
6
7
8
9
10
11
<style type="text/css">
.class1{
font-size: 15px;
color: brown;
}
</style>
<p class="class1">

aaa ***b***

</p>

aaa b

编辑器

typora

0.11.18 免费beta版链接: https://typora.io/releases/all

marktext

open source

https://github.com/marktext/marktext

vscode


  1. https://x-zeppelin.github.io/ ↩︎

-------------end-------------