Markdown 语法集

Markdown 语法集合

1 强调

星号与下划线都可以，单星号是斜体，双星号是粗体，符号可跨行，符号可加空格

1
2
3
4
5
6
**我的博客**
__非常优秀__

*认清形势，
放弃幻想，
开始斗争*

我的博客

非常优秀

认清形势，

放弃幻想，

开始斗争

2 分割线

三个或更多-_*，必须单独一行，可含空格

1
2
3
---
***
___

3 引用

1
> 引用

引用

内层符号前的空格必须要

1
2
>引用
 >>引用中的引用

引用

引用中的引用

4 标题：Setext方式

三个或更多

1
2
3
4
大标题
===
小标题
---

A大标题

B小标题

5 标题：Atx方式

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题123456

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

6 无序列表

符号之后的空格不能少，-+*效果一样，但不能混合使用，因混合是嵌套列表，内容可超长

1
2
3
4
- 无序列表
- 无序列表
- 无序列表
- 无序列表：我很长。我也很长！那比一比啊
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表：我很长。我也很长！那比一比啊
    符号之后的空格不能少，-+*效果一样，但不能混合使用，因混合是嵌套列表
1
2
3
4
* 无序列表
* 无序列表
* 无序列表
* 无序列表：我很长。我也很长！那比一比啊1234

  • 无序列表

  • 无序列表

  • 无序列表

  • 无序列表：我很长。我也很长！那比一比啊

7 有序列表

数字不能省略但可无序，点号之后的空格不能少

1
2
3
4
1. 有序列表
2. 有序列表
3. 有序列表
4. 有序列表
  1. 有序列表
  2. 有序列表
  3. 有序列表
  4. 有序列表

8 嵌套列表

-+*可循环使用，但符号之后的空格不能少，符号之前的空格也不能少

1
2
3
4
5
6
- 嵌套列表1
 + 嵌套列表2
 + 嵌套列表3
  - 嵌套列表4
   * 嵌套列表5
- 嵌套列表6
  • 嵌套列表1
    • 嵌套列表2
    • 嵌套列表3
    • 嵌套列表4
    • 嵌套列表5
  • 嵌套列表6

9 文字超链：Inline方式

Tooltips可省略

1
[我的链接](https://frong0824.github.io/)

我的链接

图片超链

多个感叹号，Tooltips可省略，要设置大小只能借助HTML标记

1
![]()  # 常采用Typora的图片插入和打包功能

10 自动链接

尖括号

1
2
<http://localhost:4000/about/>
<abcdefg@qq.com>

http://localhost:4000/about/

abcdefg@qq.com

11 代码：行内代码

在第一行后指定编程语言，也可以不指定

1
​``` python
1
2
3
4
5
6
@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None

12 表格

1
2
3
|Project|Num|
|-|-|
|abc|384|
Project Num
abc 384

13 段落缩进（空格）

1
2
3
4
不断行的空白格:空&nbsp;&nbsp;&nbsp;&nbsp;&#160;白
半方大的空白:空&ensp;&#8194;白
全方大的空白:空&ensp;&#8195;白
&emsp;&emsp;段落缩进的空白

不断行的空白:空  白（等同于敲下空格键）

半方大的空白:空  白

全方大的空白:空  白

  段落缩进的空白

14 字体设置

1
2
3
4
5
<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=gray size=5>gray</font>

我是黑体字
我是微软雅黑
我是华文彩云
变色变大的黑体
变灰gray

Tag插件 -配合Fluid主题

1
2
3
{% note success %}
文字 或者 `markdown` 均可
{% endnote %}

文字 或者 markdown 均可

secondary

danger

warning

info

勾选框

1
{% cb text, checked?, incline? %}
  • text：显示的文字
  • checked：默认是否已勾选，默认 false
  • incline: 是否内联（可以理解为后面的文字是否换行），默认 false
普通示例
默认选中
内联示例 后面文字不换行
也可以只传入一个参数，文字写在后边（这样不支持外联）

组图

如果想把多张图片按一定布局组合显示，你可以在 markdown 中按如下格式：

1
2
3
4
5
6
7
{% gi total n1-n2-... %}
  ![](url)
  ![](url)
  ![](url)
  ![](url)
  ![](url)
{% endgi %}
  • total：图片总数量，对应中间包含的图片 url 数量
  • n1-n2-…：每行的图片数量，可以省略，默认单行最多 3 张图，求和必须相等于 total，否则按默认样式
  • 如下图为 {% gi 5 3-2 %} 示例，代表共 5 张图，第一行 3 张图，第二行 2 张图。

LaTeX 数学公式

TIP

Hexo 5.0 以上，可尝试 Hexo 官方的 hexo-math (opens new window)插件，支持更多定制化参数，使用方式参照仓库内的文档，以下介绍的是主题内置的 LaTeX 功能。

当需要使用 LaTeX (opens new window)语法的数学公式时，可手动开启本功能，需要完成三步操作：

1. 设置主题配置

1
2
3
4
5
post:
  math:
    enable: true
    specific: false
    engine: mathjax
  • specific: 建议开启。当为 true 时，只有在文章 Front-matter (opens new window)里指定 math: true 才会在文章页启动公式转换，以便在页面不包含公式时提高加载速度。
  • engine: 公式渲染引擎，目前支持 mathjax 或 katex。

2. 更换 Markdown 渲染器

由于 Hexo 默认的 Markdown 渲染器不支持复杂公式，所以必须更换渲染器。

先卸载原有渲染器：

1
npm uninstall hexo-renderer-marked --save

然后根据上方配置不同的 engine，推荐更换如下渲染器：

mathjax: npm install hexo-renderer-kramed --save

katex: npm install @upupming/hexo-renderer-markdown-it-plus --save

3. 安装完成后执行 hexo clean

书写公式的格式：

1
2
3
$$
E=mc^2
$$

WARNING

不可同时安装多个渲染器，如果更换公式引擎，对应渲染器也要一并更换。

如果公式没有被正确渲染，请仔细检查是否符合上面三步操作。

另外不同的渲染器，可能会导致一些 Markdown 语法不支持。

自定义页面默认不加载渲染，如需使用，需在 Front-matter 中指定 math: true



参考网站

https://blog.csdn.net/qcx321/article/details/53780672

https://fluid-dev.github.io/hexo-fluid-docs/guide/