Markdown - 轻文本格式

注意
本文最后更新于 2023-12-01,文中内容可能已过时。

Markdown - 轻文本格式

官方首页,我采用的编辑器为 MarkText,开源地址(GitHub),文档目录语法手册

基础语法

  1. 标题的#和标题之间需要有一个空格
  2. 结束一行需要在最后敲两个以上的空格,然后回车,空格换行这个比较有争议,最完美的方式是在行末放上一个<br>,不过在 Mart Text 中没有这样的烦恼
  3. 加粗或者斜体都最好用*,而不是_, 在字符的前后用三个*表示同时使用加粗和斜体
  4. 无序列表最方便的是用- 。在列表中加入别的元素然后再继续编号这个 Mark Text 已经优化的很好,按回车就可以搞定了,回车还可以跳出列表标号的自动标注,变成普通的一行,多级列表可以通过按Tab调整层级
  5. 表示代码的那个反引号,需要在英文输入法下点击 esc 下面那个按键才能按出来
  6. 表示代码块可以直接按四个空格,比 Mark Text 中的快捷键快多了
  7. 水平线用-最方便,直接敲三个-比快捷键快
  8. 链接网址的括号里在网址的后面空格之后加上引号,引号里写的一段话,这段话会在鼠标放到链接上的时候显示,Mark Text 快捷键Ctrl+L
  9. 这个引用链接 很有意思,跟论文一样,不过在 Mart Text 中,第一部分的两个中括号不能分开,否则无法识别
  10. URL 中的空格统一用%20表示
  11. 图片的格式和链接很像,区别是图片以!开头,图片的插入 Mark Text 已经优化得非常好了,快捷键Ctrl+Shift+I
  12. 转义字符\
  13. MarkDown 中可以直接使用 HTML 标签,这很方便。

高级语法

  1. 原生的表格用|-来画表格的写法其实很繁琐,Mark Text 对表格得支持很好,快捷键Ctrl+Shift+T,官方说想要在表格中画|的话可以通过 HTML 符号&#124;,我用了,没有效果
  2. 围栏代码块(Fenced Code Blocks),和之前的敲四个空格代码块的渲染的是一样的东西(按道理来说应该是不一样的东西,但是 Mart Text 渲染成一样的东西了)。也可以通过敲三个反引号调出。代码块最大的好处就是可以通过输入代码语言来进行语法高亮。
  3. Mark Text 好像不支持 footnote,不过没关系,引用链接 已经够用了
  4. Mark Text 的 heading id 和 MarkDown 的 heading id 功能不一样,具体看Mark Text 手册,这个功能无法实现在 editor 中的跳转,只能在网页中实现跳转,其实就是个 A 标签。
  5. Mark Text 不支持定义列表(definition list)
  6. Mart Text 对任务列表的支持非常好,快捷键Ctrl+Alt+X
  7. 表情,先输入两个连续英文冒号,然后在两个冒号中间输入表情短码(只能是英文),输入的过程中 Mark Text 会有表情预览,非常方便

数学公式

参考:Markdown 数学公式语法 - 简书

其他的更复杂的请参考:史上最全 Markdown 公式、符号总结!!!-CSDN 博客

行内与独行

  1. 行内公式:将公式插入到本行内,符号:$公式内容$,如:$xyz$

  2. 独行公式:将公式插入到新的一行内,并且居中,符号:$$公式内容$$,如:

    $$ xyz $$

上标、下标与组合

  1. 上标符号,符号:^,如:$x^4$,注意,如果指数有多位,则需要用{}包起来,例如$x^{100}$
  2. 下标符号,符号:_,如:$x_1$
  3. 组合符号,符号:{},如:${16}{8}O{2+}{2}$

字体与格式

  1. 字体控制,符号:\displaystyle,如:$\displaystyle \frac{x+y}{y+z}$

  2. 下划线符号,符号:\underline,如:$\underline{x+y}$

  3. 标签,符号\tag{数字},如:

    $$ \tag{1} $$

  4. 上大括号,符号:\overbrace{算式},如:$\overbrace{a+b+c+d}^{2.0}$

  5. 下大括号,符号:\underbrace{算式},如:$a+\underbrace{b+c}_{1.0}+d$

  6. 上位符号,符号:\stacrel{上位符号}{基位符号},如:$\vec{x}\stackrel{\mathrm{def}}{=}{x_1,\dots,x_n}$

占位符

  1. 两个 quad 空格,符号:\qquad,如:$x \qquad y$
  2. quad 空格,符号:\quad,如:$x \quad y$
  3. 大空格,符号\,如:$x \ y$
  4. 中空格,符号\:,如:$x : y$
  5. 小空格,符号\,,如:$x , y$
  6. 没有空格,符号``,如:$xy$
  7. 紧贴,符号\!,如:$x ! y$

定界符与组合

  1. 括号,符号:()\big(\big) \Big(\Big) \bigg(\bigg) \Bigg(\Bigg),如:$()\big(\big) \Big(\Big) \bigg(\bigg) \Bigg(\Bigg)$
  2. 中括号,符号:[],如:$[x+y]$
  3. 大括号,符号:\{ \},如:${x+y}$
  4. 自适应括号,符号:\left \right,如:$\left(x\right)$,$\left(x{yz}\right)$
  5. 组合公式,符号:{上位公式 \choose 下位公式},如:${n+1 \choose k}={n \choose k}+{n \choose k-1}$
  6. 组合公式,符号:{上位公式 \atop 下位公式},如:$\sum_{k_0,k_1,\ldots>0 \atop k_0+k_1+\cdots=n}A_{k_0}A_{k_1}\cdots$

四则运算

  1. 加法运算,符号:+,如:$x+y=z$
  2. 减法运算,符号:-,如:$x-y=z$
  3. 加减运算,符号:\pm,如:$x \pm y=z$
  4. 减甲运算,符号:\mp,如:$x \mp y=z$
  5. 乘法运算,符号:\times,如:$x \times y=z$
  6. 点乘运算,符号:\cdot,如:$x \cdot y=z$
  7. 星乘运算,符号:\ast,如:$x \ast y=z$
  8. 除法运算,符号:\div,如:$x \div y=z$
  9. 斜法运算,符号:/,如:$x/y=z$
  10. 分式表示,符号:\frac{分子}{分母},如:$\frac{x+y}{y+z}$
  11. 分式表示,符号:{分子} \voer {分母},如:${x+y} \over {y+z}$
  12. 绝对值表示,符号:||,如:$|x+y|$

高级运算

  1. 平均数运算,符号:\overline{算式},如:$\overline{xyz}$
  2. 开二次方运算,符号:\sqrt,如:$\sqrt x$
  3. 开方运算,符号:\sqrt[开方数]{被开方数},如:$\sqrt[3]{x+y}$
  4. 对数运算,符号:\log,如:$\log(x)$
  5. 极限运算,符号:\lim,如:$\lim^{x \to \infty}_{y \to 0}{\frac{x}{y}}$
  6. 极限运算,符号:\displaystyle \lim,如:$\displaystyle \lim^{x \to \infty}_{y \to 0}{\frac{x}{y}}$
  7. 求和运算,符号:\sum,如:$\sum^{x \to \infty}_{y \to 0}{\frac{x}{y}}$
  8. 求和运算,符号:\displaystyle \sum,如:$\displaystyle \sum^{x \to \infty}_{y \to 0}{\frac{x}{y}}$
  9. 积分运算,符号:\int,如:$\int^{\infty}_{0}{xdx}$
  10. 积分运算,符号:\displaystyle \int,如:$\displaystyle \int^{\infty}_{0}{xdx}$
  11. 微分运算,符号:\partial,如:$\frac{\partial x}{\partial y}$
  12. 矩阵表示,符号:\begin{matrix} \end{matrix},如:$ \begin{matrix} 1 & 2 & 3 \ 4 & 5 & 6 \ 7 & 8 & 9 \end{matrix} $

逻辑运算

  1. 等于运算,符号:=,如:$x+y=z$
  2. 大于运算,符号:>,如:$x+y>z$
  3. 小于运算,符号:<,如:$x+y<z$
  4. 大于等于运算,符号:\geq,如:$x+y \geq z$
  5. 小于等于运算,符号:\leq,如:$x+y \leq z$
  6. 不等于运算,符号:\neq,如:$x+y \neq z$
  7. 不大于等于运算,符号:\ngeq,如:$x+y \ngeq z$
  8. 不大于等于运算,符号:\not\geq,如:$x+y \not\geq z$
  9. 不小于等于运算,符号:\nleq,如:$x+y \nleq z$
  10. 不小于等于运算,符号:\not\leq,如:$x+y \not\leq z$
  11. 约等于运算,符号:\approx,如:$x+y \approx z$
  12. 恒定等于运算,符号:\equiv,如:$x+y \equiv z$

集合运算

  1. 属于运算,符号:\in,如:$x \in y$
  2. 不属于运算,符号:\notin,如:$x \notin y$
  3. 不属于运算,符号:\not\in,如:$x \not\in y$
  4. 子集运算,符号:\subset,如:$x \subset y$
  5. 子集运算,符号:\supset,如:$x \supset y$
  6. 真子集运算,符号:\subseteq,如:$x \subseteq y$
  7. 非真子集运算,符号:\subsetneq,如:$x \subsetneq y$
  8. 真子集运算,符号:\supseteq,如:$x \supseteq y$
  9. 非真子集运算,符号:\supsetneq,如:$x \supsetneq y$
  10. 非子集运算,符号:\not\subset,如:$x \not\subset y$
  11. 非子集运算,符号:\not\supset,如:$x \not\supset y$
  12. 并集运算,符号:\cup,如:$x \cup y$
  13. 交集运算,符号:\cap,如:$x \cap y$
  14. 差集运算,符号:\setminus,如:$x \setminus y$
  15. 同或运算,符号:\bigodot,如:$x \bigodot y$
  16. 同与运算,符号:\bigotimes,如:$x \bigotimes y$
  17. 实数集合,符号:\mathbb{R},如:$\mathbb{R}$
  18. 自然数集合,符号:\mathbb{Z},如:$\mathbb{Z}$
  19. 空集,符号:\emptyset,如:$\emptyset$

数学符号

  1. 无穷,符号:\infty,如:$\infty$
  2. 虚数,符号:\imath,如:$\imath$
  3. 虚数,符号:\jmath,如:$\jmath$
  4. 数学符号,符号\hat{a},如:$\hat{a}$
  5. 数学符号,符号\check{a},如:$\check{a}$
  6. 数学符号,符号\breve{a},如:$\breve{a}$
  7. 数学符号,符号\tilde{a},如:$\tilde{a}$
  8. 数学符号,符号\bar{a},如:$\bar{a}$
  9. 矢量符号,符号\vec{a},如:$\vec{a}$
  10. 数学符号,符号\acute{a},如:$\acute{a}$
  11. 数学符号,符号\grave{a},如:$\grave{a}$
  12. 数学符号,符号\mathring{a},如:$\mathring{a}$
  13. 一阶导数符号,符号\dot{a},如:$\dot{a}$
  14. 二阶导数符号,符号\ddot{a},如:$\ddot{a}$
  15. 上箭头,符号:\uparrow,如:$\uparrow$
  16. 上箭头,符号:\Uparrow,如:$\Uparrow$
  17. 下箭头,符号:\downarrow,如:$\downarrow$
  18. 下箭头,符号:\Downarrow,如:$\Downarrow$
  19. 左箭头,符号:\leftarrow,如:$\leftarrow$
  20. 左箭头,符号:\Leftarrow,如:$\Leftarrow$
  21. 右箭头,符号:\rightarrow,如:$\rightarrow$
  22. 右箭头,符号:\Rightarrow,如:$\Rightarrow$
  23. 底端对齐的省略号,符号:\ldots,如:$1,2,\ldots,n$
  24. 中线对齐的省略号,符号:\cdots,如:$x_1^2 + x_2^2 + \cdots + x_n^2$
  25. 竖直对齐的省略号,符号:\vdots,如:$\vdots$
  26. 斜对齐的省略号,符号:\ddots,如:$\ddots$

希腊字母

字母 实现 字母 实现
A A α \alhpa
B B β \beta
Γ \Gamma γ \gamma
Δ \Delta δ \delta
E E ϵ \epsilon
Z Z ζ \zeta
H H η \eta
Θ \Theta θ \theta
I I ι \iota
K K κ \kappa
Λ \Lambda λ \lambda
M M μ \mu
N N ν \nu
Ξ \Xi ξ \xi
O O ο \omicron
Π \Pi π \pi
P P ρ \rho
Σ \Sigma σ \sigma
T T τ \tau
Υ \Upsilon υ \upsilon
Φ \Phi ϕ \phi
X X χ \chi
Ψ \Psi ψ \psi
Ω \v ω \omega

视频

Markdown 本身不具有插入视频的功能。但是 Markdown 支持 HTML 的标签,在 HTML 中我们可以用<video>标签插入视频

1
2
3
<video width="320" height="240" controls>
    <source src="movie.mp4" type="video/mp4">
</video>

或者

1
<video src="movie.mp4.mp4" controls="controls" width="500" height="300"></video>

当然,除了.mp4它还支持其他的格式,但原生仅支持播放 ogg/mp4/webm 格式。不支持播放 FLV 格式视频。

Type Filename Extension
video/ogg ogg /ogv /ogm
video/webm webm
video/mp4 mp4

然而,浏览器并不是都支持相同的视频格式,所以你可以在 <source> 元素里提供多个视频源,然后浏览器将会使用它所支持的第一个源。

1
2
3
4
5
6
7
<video width="320" controls loop>
  <source src="myVideo.mp4" type="video/mp4">
  <source src="myVideo.webm" type="video/webm">
  <source src="myVideo.ogv" type="video/ogg" />
  <p>Your browser doesn't support HTML5 video. Here is
     a <a href="myVideo.mp4">link to the video</a> instead.</p>
</video>

属性:

  • controls : 允许用户控制视频的播放,包括音量,跨帧,暂停/恢复播放。
  • width : 视频显示区域的宽度,单位是 CSS 像素。
  • height : 展示区域的高度,单位是 CSS 像素。
  • loop : 布尔属性;指定后,会在视频结尾的地方,自动返回视频开始的地方。
  • src : 要嵌到页面的视频的 URL。可选;你也可以使用 video 块内的 <source> 元素来指定需要嵌到页面的视频。

参阅 HTML5 <video> 元素,和 使用 HTML5 音频和视频

MarkText

MarkText

MarkText 的图表 还挺有意思的,主要来自于 flowchart.js, mermaid and Vega-Lite 的支持,把这几个语言中的画图的脚本复制进来即可,棒!

关注 MarkText 更新,

  • 看什么啥时候能加上 File Session

  • 默认不适用打字机模式,只有撤销的时候才用打字机模式。PS:打字机模式下,滚动条会跟随鼠标位置

MarkText 只是个一般的应用,性能比不上 Sublime 或者 VSCode,不管是性能也好,快捷键也好,还是版本管理,要么就是很羸弱,要么直接没有,所以平常心看代 MarkText 就好。

换到 VScode 加插件的模式

有几个插件可选择

在 VSCode 中编写 md 的体验还是太差,还是换回 MarkText,:sob::sob::sob::sob::sob::sob:

其他

Markdown 这个语法,是非常适合文档写作的,因为它有丰富的图形显示,比如列表,表格,图片,关系图甚至是表情。

0%