博客园Markdown帮助文档

目录

• 1 一级标题
  • 1.1 二级标题
• 2 高阶标题（效果和一级标题一样 ）
  • 2.1 次阶标题（效果和二级标题一样）
• 3 目录
  • 3.1 注意事项
• 4 引用
  • 4.1 示例
  • 4.1 代码
  • 4.2 注意
• 5 代码块
  • 5.1 示例
  • 5.2 注意
• 6 行内代码
  • 6.1 示例
  • 6.2 注意
• 7 导入图片
  • 7.1 示例
  • 7.2 注意
• 8 列表
  • 8.1 示例
  • 8.2 注意
• 9 粗体和斜体
  • 9.1 示例
  • 9.2 注意
• 10 表格
  • 10.1 示例
  • 10.2 注意
• 11 分割线
  • 11.1 示例
  • 11.2 注意
• 12 链接
  • 12.1 示例
  • 12.2 注意
• 13 反斜杠
  • 13.1 示例
• 14 空格
• 15 标签分类
  • 15.1 示例
• 16 删除线
  • 16.1 说明
  • 16.2 示例
• 17 注脚
  • 17.1 示例
  • 17.2 注意
• 18 实现页内跳转
  • 18.1示例
• 19 流程图
• 20 LaTeX公式
  • 20.1 示例1
  • 20.2 注意
  • 20.3 解决方案

1 一级标题

  使用 [#] 或 [=] 生成标题。

1.1 二级标题

  1. 一级标题可以使用 [# 标题] 的形式，二级标题使用 [## 标题] 的形式，以此类推，共有六级标题；注意[#]和[标题]之间最好加一个空格，防止标题无法识别。
  2. 使用 [=] 表示高阶标题，使用 [-] 表示次阶标题，其中 [=] 和 [-] 符号的数量>=1。
  3. 注意：通常在标题分级时使用标题标记；

2 高阶标题（效果和一级标题一样 ）

2.1 次阶标题（效果和二级标题一样）

3 目录

  使用[TOC]生成目录。如一开始的目录所示。

3.1 注意事项

  1. 如果你的标题都是按照Markdown语法书写的话，可以自动生成层级目录。
  2. [TOC] 标记可能只能放在一级标题的前面，视不同的编译器而定。

4 引用

  使用 [>] 表示引用，[>>] 表示引用里面再套一层引用，依次类推。

4.1 示例

这是一级引用

这是二级引用

这是三级引用

4.1 代码

[#> 这是一级引用]
[#>> 这是二级引用]
[#>>> 这是三级引用]

4.2 注意

1. 如果[>]和[>>]嵌套使用的话，从[>>]退到[>]时，必须之间要加一个空格或者[>]作为过渡，否则默认为下一行和上一行是同一级别的引用。如示例所示。
2. 引用标记里可以使用其他标记，如：有序列表或无序列表标记，代码标记等。
3. 通常在引用别人的话或者某些时候做说明时使用引用标记。

5 代码块

使用```表示代码块。

5.1 示例

var canvas = document.getElementById("canvas");
var context = canvas.getContext("2d");

5.2 注意

  1. [`]这个符号是在Esc键下面，切换到英文下即可。
  2. [```]后面的javascript表示此段代码为javascript代码，Markdown会自行使用javascript代码颜色渲染。这里也可以不写。
  3. 本文档所有使用讲解Markdown语法标记示例的地方都是使用代码块标记的。

6 行内代码

  使用[``]表示行内代码。

6.1 示例

  这是`javascript`代码

6.2 注意

  1. 本页部分文字中间的英文字母就是使用行内代码标记标记的。

7 导入图片

使用![Alt text](/path/to/img.jpg "Optional title")导入图片。其中：
  1. [Alt text]为如果图片无法显示时显示的文字；
  2. [/path/to/img.jpg]为图片所在路径；
  3. [Optional title]为显示标题。显示效果为在你将鼠标放到图片上后，会显示一个小框提示，提示的内容就是[Optional title]里的内容。

7.1 示例

  `![Markdown](https://images0.cnblogs.com/blog/404392/201501/122257231047591.jpg`

7.2 注意

1. 导入的图片路径可以使用绝对路径也可以使用相对路径，建议使用相对路径。
2. 通常的做法是Markdown文档的同级目录下建立一个pictures文件夹，里面放置所有所需的图片，如果图片多的话，你也可以在pictures文件夹里建立子文件夹归类。

8 列表

使用 [1. 2. 3.] 表示有序列表，使用 [*] 或 [-] 或 [+] 表示无序列表。

8.1 示例

A. 有序列表

1. 第一点
2. 第二点
3. 第三点

1. 第一点
2. 第二点
3. 第三点

B. 无序列表

+ 呵呵
    * 嘉嘉
    - 嘻嘻
    - 吼吼
        - 嘎嘎
        + 萌萌
* 哈哈

• 呵呵
  • 嘉嘉
  • 嘻嘻
  • 吼吼
    • 嘎嘎
    • 萌萌

• 哈哈

8.2 注意

1. 无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
2. 有序列表标记不是按照你写的数字进行显示的，而是根据当前有序列表标记所在位置显示的，如示例1所示。
3. 无序列表的项目符号是按照实心圆、空心圆、实心方格的层级关系递进的，如例2所示。通常情况下，同一层级使用同一种标记表示，便于自己查看和管理。
4. 无序列表和有序列表标记的使用场景也很明了，故不多说。

9 粗体和斜体

使用 [**] 或者 [__] 表示粗体。
使用 [*] 或者 [_] 表示斜体。

9.1 示例

 **粗体1**    __粗体2__
 *斜体1*    _斜体2_

粗体1 粗体2
斜体1 斜体2

9.2 注意

1. 前后的 [*] 或 [_] 与要加粗或倾斜的字体之间不能有空格。

10 表格

------:为右对齐。
:------为左对齐。
:------:为居中对齐。
-------为使用默认居中对齐。

10.1 示例

|         序号    |    交易名    |    交易说明    |    备注    |
|    ------: |    :-------:    |    :---------   |    ------    |
|    1    |    prfcfg    |    菜单配置    |    对应关系    |
|    2    |    gentmo    |    编译所有交易    |    |
|    100000    |    sysdba    |    数据库表模型汇总    |    |

序号	交易名	交易说明	备注
1	prfcfg	菜单配置	对应关系
2	gentmo	编译所有交易
100000	sysdba	数据库表模型汇总

10.2 注意

1. 每个Markdown解析器都不一样，可能左右居中对齐方式的表示方式不一样。

11 分割线

使用 [---] 或者 [**] 或者 [ * *] 表示水平分割线。

11.1 示例

---

***

* * *

---

---

---

11.2 注意

1. 只要[*]或者[-]大于等于三个就可组成一条平行线。
2. 使用[---]作为水平分割线时，要在它的前后都空一行，防止[---]被当成标题标记的表示方式。

12 链接

1. 使用表示行内链接。其中：

• []内的内容为要添加链接的文字。
• [link]为链接地址。
• [Optional title]为显示标题。显示效果为在你将鼠标放到链接上后，会显示一个小框提示，提示的内容就是[Optional title]里的内容。

12.1 示例

例1：行内链接

 * 这就是我们常用的地址：[Baidu](https://www.baidu.com "百度一下，你就知道" )

• 这就是我们常用的地址：Baidu

例2：参考式链接

 * 这就是我们常用的地址：[Baidu][1] [GoolGle][2]

[1]:https://www.baidu.com "百度一下，你就知道" 
[2]:https://www.google.com "谷歌一下，你就知道" 

• 这就是我们常用的地址：Baidu GoolGle

12.2 注意

参考式链接和行内链接的显示效果是一样的，但是在编辑状态下的使用情况不一样。
行内连接紧跟链接文字，可以在看到链接文字的同时清楚的知道链接地址，但是不便于多次重复利用。
参考式链接可以重复使用，但一般都是将一些链接放在一起统一管理，如一段文字后面或文章结尾，
因此在找到链接和链接文字的对应关系上有些麻烦。各有利弊了，分情况使用。

13 反斜杠

使用 \ 表示反斜杠。在你不想显示Markdown标记时可以使用反斜杠。

13.1 示例

\*这里不会显示斜体\*

这里不会显示斜体

14 空格

Markdown语法会忽略首行开头的空格，如果要体现出首行开头空两个的效果，可以使用全角符号下的空格，windows下使用 [shift+空格] 切换。

15 标签分类

使用 [标签:] 或者 [Tags:] 表示标签标记。

15.1 示例

标签: 数学 英语
Tags: 数学 英语

标签: 数学 英语
Tags: 数学 英语

16 删除线

使用 [~~] 表示删除线。

16.1 说明

~~这是一条删除线~~

这是一条删除线

16.2 示例

1. 注意 [~~] 和要添加删除线的文字之间不能有空格。
2. 我常使用在显示的告诉自己这行文字是要删除的。

17 注脚

使用 [^footer] 表示注脚。

17.1 示例

这是一个注脚测试[^footer1]。
[^footer1]: 这是一个测试，用来阐释注脚。

这是一个注脚测试^[1]。

17.2 注意

我常在需要解释一个名词，或者一本书，或者一个人时使用脚注标记。

18 实现页内跳转

使用html代码实现页内跳转。在要跳转到的位置定义个锚 <span id = "jump">hehe</span>，然后使用 [你好](#jump) 将你好设置为一单击即跳转到hehe所在位置的效果。

18.1示例

[你好](#jump)
<span id = "jump">hehe</span>

你好
hehe

19 流程图

以后在总结吧，现在的我完全没有使用上，没有需求就先不总结了。

20 LaTeX公式

LaTeX 提供了对数学公式的支持。行内公式用 $ 包起来即可；行间公式用 $$ 包起来，或使用 \begin{equation} 带编号的数学公式 \end{equation} 等命令。
除此之外，数学公式还支持 Unicode 写法，即不使用 LaTeX 命令，直接键入 Unicode 字符，如 α。

20.1 示例1

$$
F(x)=\int_0^t\sin(t)\mathrm{d}\,t+\left[\lim_{x\rightarrow0}g(x)\times\sum_{m=0}^\infty\frac{(-1)^m}{\Gamma(m+{\color{red}α}+1)}\right]
$$

\[F(x)=\int_0^t\sin(t)\mathrm{d}\,t+\left[\lim_{x\rightarrow0}g(x)\times\sum_{m=0}^\infty\frac{(-1)^m}{\Gamma(m+{\color{red}α}+1)}\right] \]

如需引用公式，应该先用 \label{公式名} 标记被引用的公式，然后在正文中用 \ref{公式名} 引用该公式，如（\ref{name}）。

20.2 注意

Markdown 与 LaTeX 的语法规则存在歧义：

• 编辑器支持 Markdown 的语法，如 斜体、斜体 以及输入特殊符号的转义符号 \；
• 编辑器同时也支持 LaTeX 输入数学公式，数学公式用 * 表示乘法，用 _ 表示下标，用 \ 表示（多行公式与矩阵等）换行；

原因分析与初步解决方法：

• 在 Markdown 编辑器里输入 LaTex 的矩阵等无法换行，究其原因是由于 \ 会被 Markdown 优先转化为 \；
• 根据上述猜想，发现如果使用 \\ 替代原 LaTex 命令 \ 即可，同理 * 与 _ 代替 * 与 _；
• 但由于 特殊字符的自动转换，在公式存在多个 * 或 _ 符号时，有时候也会出现问题。

因此，博客园的 Markdown 编辑器还存在很多不足之处，希望官方尽快推出解决方法（譬如：在 LaTex 环境中禁用 Markdown 语法格式），否则只能采用下面的方法凑合了。

$$
\dot{x} = \mathbf{A}x + \mathbf{B}u
$$

\[\dot{x} = \mathbf{A}x + \mathbf{B}u \]

20.3 解决方案

如果您在 Mardown 编辑器中不仅输入 Markdown，还想输入 LaTeX 数学公式，需要将 LaTeX 数学公式放在某个 HTML 标签之中，比如 <p> </p> ，
这样可以避免数学公式中的一些字符被 Markdown 引擎处理。

其实这是利用 Markdown 不会处理位于 HTML 区块标签间内容这一特点。

---

1. 这是一个测试，用来阐释注脚。 ↩︎