跳转至

:simple-markdown: Markdown语法学习 精简版

文章开头

介绍一下Markdown:
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为 .md, .markdown。

此笔记学习摘抄自Markdown语法学习 精简版,学习借鉴大佬之经验(Ctrl C+V)

也推荐看:Markdown中文指南

一些Markdown文档创作工具:

最常用

分级标题

1
2
3
4
5
6
# 一级标题 (注意有空格)
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题  <!--最多6级标题-->

目录

在任意位置插入 [toc] 显示全文目录结构

示例见文章开头(点击这里跳转到开头查看目录)

斜体/粗体/删除线/下划线/背景高亮

1
2
3
4
5
6
*斜体*    _斜体_
**粗体**    __粗体__
***加粗斜体***    ___加粗斜体___
~~删除线~~
<u>下划线</u>
==背景高亮==

斜体 斜体

粗体 粗体

加粗斜体 加粗斜体

删除线

下划线

背景高亮

无序列表/有序列表

无序列表

1
2
3
* 无序列表项 一
+ 无序列表项 二
- 无序列表项 三
  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

多级无序列表

1
2
3
4
5
6
7
* 今天`* + 空格键`
* 明天
    * 学习 `TAB(或4个空格) + * + 空格键`
    * 购物
        * 面包
        * 牛奶
* 后天
  • 今天* + 空格键
  • 明天
    • 学习 TAB(或4个空格) + * + 空格键
    • 购物
      • 面包
      • 牛奶
  • 后天

有序列表/多级有序列表

1
2
3
4
5
6
1. 有序列表项 一 `数字 + . + 空格键`
2. 有序列表项 二
    1. 有序列表项 二(1) `TAB(或4个空格) + 数字 + . + 空格键`
    2. 有序列表项 二(2)
        1. 有序列表项 二(2).1
3. 有序列表项 三
  1. 有序列表项 一 数字 + . + 空格键
  2. 有序列表项 二
    1. 有序列表项 二(1) TAB(或4个空格) + 数字 + . + 空格键
    2. 有序列表项 二(2)
      1. 有序列表项 二(2).1
  3. 有序列表项 三

任务列表

- [ ] 任务一 未做任务 `- + 空格 + [ ]`
- [x] 任务二 已做任务 `- + 空格 + [x]`
  • 任务一 未做任务 - + 空格 + [ ]
  • 任务二 已做任务 - + 空格 + [x]

表格

第一行为表头,第二行分隔表头和主体部分(如果表格无法显示可以尝试把第二行的 - 变为 --- ),可以指定所在列的对齐方式,第三行开始每一行为一个表格行。列与列之间用 | 隔开。(注:原生方式的表格每一行的两边也要有 | )

对齐方式 :- 左对齐 - 中心对齐 -: 右对齐

1
2
3
4
5
第一列|第二列|第三列
:-|-|-:
a11|a12|a13
a21|a22|a33
a31|a32|a33
表头一 表头二 表头三
a11 a12 a13
a21 a22 a33
a31 a32 a33

超链接

[ ]里写链接文字,( )里写链接地址, ( )中的" "中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字,链接地址与title前有一个空格。

右边是链接[链接文字](链接 "title")
右边是链接[GitHub](https://github.com "GitHub")

右边是链接GitHub

插入图片

格式! [图片标题] (图片地址 "图片Title”)

其中图片标题会被某些网站和编辑器显示在图片下方

插入视频

格式

<iframe height= width= src="链接">

代码块

行内代码块

用“ ` ”左右包裹代码

`printf()` 函数  
显示为printf() 函数

多行代码块

用“ ``` ”上下包裹代码,在第一个“ ``` ”后添加语言名称获得不同的高亮效果

如:cpp,python,swift

对齐方式

1
2
3
<center>行中心对齐</center>
<p align="left">行左对齐</p>
<p align="right">行右对齐</p>

行中心对齐

行左对齐

行右对齐

分割线

1
2
3
4
* * *
***
- - -
---




换行

不同markdown编辑器可能有不同的换行方式,最简单为直接敲回车

markdown文本内的连续两个或多个回车会被替换为一个回车

高级

设置字体/颜色

<font face="宋体" color=blue size=5>蓝色的字~</font>

蓝色的字~

常用颜色

浏览器支持的所有颜色请跳转参考

现代浏览器支持的140种已命名的颜色

常用颜色名称: * 按网站顺序排列 * orange pink gold yellow purple greenyellow lightgreen green aqua lightblue blue wheat brown white snow linen silver gray black

最常用 其他
red greenyellow
orange lightgreen
yellow lightblue
green pink
aqua gold
blue silver
purple brown

锚点

也就是 跳转

1
2
3
4
5
6
1. [点击这里跳转到第一段](#jump1)
2. [点击这里跳转到第二段](#jump2)

### <span id="jump1">第一段</span>

### <span id="jump2">第二段</span>
1
2
3
<span id="now">当前位置</span>
点击[这里](#top)跳转到开头
点击[这里](#bottom)跳转到结尾

当前位置

点击这里跳转到开头

点击这里跳转到结尾

注脚

1
2
3
4
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]。

[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言

使用 Markdown1可以效率的书写文档, 直接转换成 HTML2

点击这里跳转到结尾查看注脚的显示效果

多级引用

1
2
3
4
5
6
7
>>> 请问 Markdwon 怎么用? - 小白

>> 自己看教程! - 愤青

> 教程在哪? - 小白

`[^_^]: # 无法显示时记得空行`

不同编辑器的显示情况不同

请问 Markdwon 怎么用? - 小白

自己看教程! - 愤青

教程在哪? - 小白

LaTeX公式

  • 在数学公式的前后加$是行内公式
我们在初中数学课上已经对一次函数$y=x+a$有所了解。

我们在初中数学课上已经对一次函数\(y=x+a\)有所了解。

  • 在数学公式的前后加$$是独占一行的公式
    下面我们来认识一下二次函数$$y=ax^2+bx+c$$
    
    下面我们来认识一下二次函数\(\(y=ax^2+bx+c\)\)

1
2
3
4
5
6
行内公式:$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
块级公式:
$$  x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
$$ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } } $$

行内公式:\(\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N\)

块级公式:

\[x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a}\]
\[\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}{1+\frac{e^{-8\pi}} {1+\ldots} } } }\]

来看看两个重要极限

\[\displaystyle\lim_{x \rightarrow 0}\frac{\sin x}{x} = 1\]
\[\displaystyle\lim_{x \rightarrow + \infty}(1 + \frac{1}{x})^x = e\]

其他

转义字符

通过在Markdown字符前使用\来忽略(或转义)Markdown格式。

Markdown允许您使用反斜杠转义来生成文字字符,否则这些字符在Markdown的格式化语法中具有特殊含义。 例如,如果您想用文字星号包围一个单词,则可以在星号之前使用反斜杠,如\*literal asterisks\* *literal asterisks*

Markdown为以下字符提供反斜杠转义(但是CSDN不太支持):

\反斜杠 `反引号 *星号 _下划线 {}大括号 []中括号 ()小括号  #井号 +加号 -减号 .英文句号 !英文感叹号

内联 HTML 语法/特殊字符自动转义

对于 Markdown 中未包含的标签, 可以直接使用 HTML标签,例如用 HTML <a> 标签替代 Markdown 的链接语法

在 HTML 中, 有一些字符需要特殊对待,如果你想将它们用作字面量, 则需要将它们转义为字符实体

特殊字符 代码
& &amp;
< &lt;
> &gt;
" &quot; &#34;
' &apos; &#39;

注释

1
2
3
<div style='display: none'>
注释
</div>
<!-- 注释 -->
[//]: # (哈哈我是最强注释1,不会在浏览器中显示。)
[^_^]: # (哈哈我是最萌注释2,不会在浏览器中显示。)

空格

1
2
3
【1】 &nbsp; 半角的不断行的空白格(推荐使用)
【2】 &ensp; 半角的空格
【3】 &emsp; 全角的空格
  • 【1】   半角的不断行的空白格(推荐使用)
  • 【2】   半角的空格
  • 【3】   全角的空格

同时推荐这个网站去学习基础markdown语法:runoob.com


  1. Markdown是一种纯文本标记语言 

  2. HyperText Markup Language 超文本标记语言