MarkDown语法使用

Posted xichenhome

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了MarkDown语法使用相关的知识,希望对你有一定的参考价值。

一、前言

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。    --摘自百度百科

没想到一向不太靠谱的百度百科这次竟有了如此精辟的解释。之前项目一直使用word撰写文档,有比较大的弊病:

  • 只能对纯文本文件进行版本控制,而word是二进制格式
  • 格式繁杂,经常需要中断写作来控制格式
  • 代码与文档分离,给写文档造成更大的阻力

而假如单纯的使用txt,就没有一点格式了,用html虽然既有格式又能加入版本控制,但是需要花费较多的时间在标签上,而且标签占了文档的较大百分比,不易阅读。

所以,最终的解决方案就是 **Markdown** ,作为一种轻量级的标记语言,能在非常短的时间内掌握。而且不仅可以用于写文档,还可以写博客、写简书、做一些随手笔记。Markdown文件以.md结尾,可以导出为html和PDF(需要使用的工具支持)。它是一种语法(个人认为是简化版的html),但是和html不同的是,各种解析器对其会有不同的表现。比如我的IDEA Markdown插件会把分割线显示成一条细灰线,Cmd Markdown则是显示一条虚线。所以建议保持使用一种Markdown工具和尽量使用标准语法。

二、Markdown基本语法

2.1 标题

代码:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 最小只有六级标题

效果:

过于粗暴,不予以展示,你复制粘贴即知晓!!!

2.2 加粗

代码:

**我被加粗了**

效果:

我被加粗了

2.3 斜体

代码:

*我倾斜了了*

效果:

我倾斜了了

2.4 高亮

代码:

==我高亮了==

效果:

==我高亮了==

2.5 上标

代码:

2^2^

效果:

2^2^

2.6 下标

代码:

H~2~o

效果:

H~2~o

2.7 代码引用(>式)

代码:

> hello markdown!

效果:

hello markdown!

代码:

> hello markdown!
>> hello markdown!

效果:

hello markdown!

hello markdown!

2.8 代码引用(```式)

代码:

# 不要复制这一句话,并且去掉下面的反斜杠,谢谢!
```python
print('hello nick')
```

效果:

print('hello nick')

2.9 代码引入(`式)

代码:

# 不要复制这一句话,并且去掉下面的反斜杠,谢谢!
`print('hello nick')`

效果:

print('hello nick')

2.10 插入链接(链接显示)

代码:

<https://www.cnblogs.com/XuChengNotes/>

效果:

https://www.cnblogs.com/XuChengNotes/

2.11 插入链接(链接描述显示)

代码:

[xucheng博客](https://www.cnblogs.com/XuChengNotes/ "xucheng博客")

效果:

xucheng博客

2.12 插入图片(链接)

代码:

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](https://image.cha138.com/20210620/21c6f34064a842b8bcd0fe4c9eb8d323.jpg '描述信息')

效果:

技术图片

2.13 插入图片(图片路径)

  • 绝对路径:.md文本同目录下图片的名字,如数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
  • 相对路径:图片在电脑中的路径地址,如Users ickmacdesktop数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

代码:

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](Users
ickmacdesktop数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')

效果:

技术图片

技术图片

2.14 有序列表

代码:

1. one
2. two 
3. three

效果:

  1. one
  2. two
  3. three

2.15 无序列表

代码:

* one
* two
* three

效果:

  • one
  • two
  • three

2.16 分割线

代码:

---

效果:


2.17 表格而且第二行必须得有,并且第二行的冒号代表对齐格式,分别为居中;右对齐;左对齐):

name | age | sex 
:-:|:-|-:
许成|20|男
陈雨行|18|女

效果:

name age sex
许成 19
陈雨行 18

2.18 数学公式(行内嵌)

代码:

内嵌数学公式$sum_{i=1}^{10}f(i),,	ext{thanks}$

效果:

内嵌数学公式∑10i=1f(i)thanks∑i=110f(i)thanks

2.19 数学公式(块状)

代码:

$$
sum_{i=1}^{10}f(i),,	ext{thanks}
$$

效果:

i=110f(i)thanks∑i=110f(i)thanks

三、如何插入上下标

^ 表示上标, _ 表示下标。如果上下标的内容多于一个字符,需要用 {} 将这些内容括成一个整体。上下标可以嵌套,也可以同时使用。

如:$$ x^{y^z}=(1+{ m e}^x)^{-2xy^w} $$,显示:$$ x^{y^z}=(1+{ m e}^x)^{-2xy^w} $$

另外,如果要在左右两边都有上下标,可以用 sideset 命令。

如:$$ sideset{^1_2}{^3_4}igotimes $$,显示:$$ sideset{^1_2}{^3_4}igotimes $$

四、如何插入括号和分隔符

()[]| 表示符号本身,使用 {} 来表示 {} 。当要显示大号的括号或分隔符时,要用 left ight 命令。

输入 显示 输入 显示
langle $ langle ?

如:$$ f(x,y,z) = 3y^2z left( 3+frac{7x+5}{1+y^2} ight) $$,显示:$$ f(x,y,z) = 3y^2z left( 3+frac{7x+5}{1+y^2} ight) $$

有时候要用 left. ight. 进行匹配而不显示本身。

如:$$ left. frac{{ m d}u}{{ m d}x} ight| _{x=0} $$,显示:$$ left. frac{{ m d}u}{{ m d}x} ight| _{x=0} $$

五 、如何输入分数

通常使用 frac {分子} {分母} 命令产生一个分数,分数可嵌套。便捷情况可直接输入 frac ab 来快速生成一个 abab 。
如果分式很复杂,亦可使用 分子 over 分母 命令,此时分数仅有一层。

如:$$ frac{a-1}{b-1} quad and quad {a+1over b+1} $$,显示:$$ frac{a-1}{b-1} quad and quad {a+1over b+1} $$

六、如何输入开方

使用 sqrt [根指数,省略时为2] {被开方数} 命令输入开方。

如:$$ sqrt{2} quad and quad sqrt[n]{3} $$,显示:$$ sqrt{2} quad and quad sqrt[n]{3} $$

七、如何输入省略号

数学公式中常见的省略号有两种,ldots 表示与文本底线对齐的省略号,cdots 表示与文本中线对齐的省略号。

如:$$ f(x_1,x_2,underbrace{ldots}_{ m ldots} ,x_n) = x_1^2 + x_2^2 + underbrace{cdots}_{ m cdots} + x_n^2 $$,显示:$ f(x_1,x_2,underbrace{ldots}{ m ldots} ,x_n) = x_1^2 + x_2^2 + underbrace{cdots}{ m cdots} + x_n^2 $

八、如何输入矢量

使用 vec{矢量} 来自动产生一个矢量。也可以使用 overrightarrow 等命令自定义字母上方的符号。

如:$$ vec{a} cdot vec{b}=0 $$,显示:$$ vec{a} cdot vec{b}=0 $$

如:$$ overleftarrow{xy} quad and quad overleftrightarrow{xy} quad and quad overrightarrow{xy} $$,显示:$$ overleftarrow{xy} quad and quad overleftrightarrow{xy} quad and quad overrightarrow{xy} $$

九、如何输入积分

使用 int_积分下限^积分上限 {被积表达式} 来输入一个积分。

如:$$ int_0^1 {x^2} ,{ m d}x $$,显示:$$ int_0^1 {x^2} ,{ m d}x $$例中 ,{ m d} 部分可省略,建议加入,使式子更美观。

十、如何输入极限运算

使用 lim_{变量 o 表达式} 表达式 来输入一个极限。如有需求,可以更改 o 符号至任意符号。

如:

$$ lim_{n 	o +infty} frac{1}{n(n+1)} quad and quad lim_{xleftarrow{示例}} frac{1}{n(n+1)} $$

显示:$$ lim_{n o +infty} frac{1}{n(n+1)} quad and quad lim_{xleftarrow{示例}} frac{1}{n(n+1)} $$

十一、如何输入累加、累成运算

使用 sum_{下标表达式}^{上标表达式} {累加表达式} 来输入一个累加。与之类似,使用 prod igcup igcap 来分别输入累乘、并集和交集。此类符号在行内显示时上下标表达式将会移至右上角和右下角。

如:

$$ sum_{i=1}^n frac{1}{i^2} quad and quad prod_{i=1}^n frac{1}{i^2} quad and quad igcup_{i=1}^{2} R $$

显示:$$ sum_{i=1}^n frac{1}{i^2} quad and quad prod_{i=1}^n frac{1}{i^2} quad and quad igcup_{i=1}^{2} R $$

十二、如何输入希腊字母

输入 小写希腊字母英文全称首字母大写希腊字母英文全称 来分别输入小写和大写希腊字母,对于大写希腊字母与现有字母相同的,直接输入大写字母即可。

输入 显示 输入 显示 输入 显示 输入 显示
alpha $ alpha A A A β

部分字母有变量专用形式,以 var- 开头

小写形式 大写形式 变量形式 显示
epsilon E varepsilon $ epsilon mid E mid varepsilon

以上是关于MarkDown语法使用的主要内容,如果未能解决你的问题,请参考以下文章

Markdown简明教程

VS Code配置markdown代码片段

VS Code配置markdown代码片段

markdown PHPExcel Notes和代码片段

markdown Git代码片段

markdown 岩组代码片段