首页 仓库（发现） 帮助
登录
guorui
/
mkdocs_pro_wcowin
1
0
派生 0
文件 工单管理 0 合并请求 0 Wiki
目录树: 46e7e92187
分支列表 标签列表
mkdocs_pro_wcow...
/
docs
/
develop
/
Markdown
/
markdown.md

markdown.md 11 KB
文件历史 原始文件

title: Markdown语法学习 精简版 comments: false tags:

  • Markdown ---

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

文章开头

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

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

也推荐看:Markdown中文指南

一些Markdown文档创作工具：

最常用

分级标题

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

目录

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

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

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

*斜体*    _斜体_
**粗体**    __粗体__
***加粗斜体***    ___加粗斜体___
~~删除线~~
<u>下划线</u>
==背景高亮==

斜体 斜体

粗体 粗体

加粗斜体 加粗斜体

删除线

下划线

==背景高亮==

无序列表/有序列表

无序列表

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

多级无序列表

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

有序列表/多级有序列表

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]

表格

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

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

第一列|第二列|第三列
:-|-|-:
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

对齐方式

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

行中心对齐

行左对齐

行右对齐

分割线

* * *
***
- - -
---

换行

不同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 ||wheat| ||linen| ||snow| ||gray| ||black|

锚点

也就是 跳转

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

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

### <span id="jump2">第二段</span>

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

当前位置

点击这里跳转到开头

点击这里跳转到结尾

注脚

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

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

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

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

[^2]:HyperText Markup Language 超文本标记语言

多级引用

>>> 请问 Markdwon 怎么用？ - 小白

>> 自己看教程！ - 愤青

> 教程在哪？ - 小白

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

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

请问 Markdwon 怎么用？ - 小白

自己看教程！ - 愤青

教程在哪？ - 小白

LaTeX公式

  • 在数学公式的前后加$是行内公式

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

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

  • 在数学公式的前后加$$是独占一行的公式

    下面我们来认识一下二次函数$$y=ax^2+bx+c$$

    下面我们来认识一下二次函数$$y=ax^2+bx+c$$

行内公式：$\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;

注释

<div style='display: none'>
注释
</div>

<!-- 注释 -->

[//]: # (哈哈我是最强注释1，不会在浏览器中显示。)
[^_^]: # (哈哈我是最萌注释2，不会在浏览器中显示。)

空格

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

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