# 标题

语句： # 标题名

n 级标题就有 n 个 #

# 斜体

语句： * 文本内容 *

# 粗体

语句： ** 文本内容 **

加粗的斜体则用三个 * 进行包围

# 公式

我们这里的 Hexo 博客使用的是 KaTex 插件，语法与 LaTex 基本一致

$$ 实现内嵌式公式， $$$$ 实现公式居中展示

KaTex 说明文档

# 行内代码

语句：一对反引号（`）

# 块代码

语句：

• 通过在代码块首尾分别添加 三个反引号 (```) 实现
• 通过对整个代码块施加 一个缩进符(Tab键) 实现（此方法需要前面空一行）

测试代码：

    // 通过缩进符实现代码块
    int main() {
        int a = 0;
        a++;
        return a;
    }

或

```
// 通过三个反引号实现代码块
int main() {
    int b = 10;
    b--;
    return b;
}
```

测试结果：

// 通过缩进展示代码块
int main() {
    int a = 0;
    a++;
    return a;
}

// 通过三个反引号实现代码块
int main() {
    int b = 10;
    b--;
    return b;
}

# 代码高亮

实现方法：

• 在三个反引号后面加上 key 值
• 常用的几个 key 值为 cpp、java、python、matlab、markdown

测试代码：

```cpp
string s;
vector<int> nums;
```

测试结果：

string s = '';
vector<int> nums;

另，用缩进符实现的代码块似乎无法实现高亮

# 链接

语句

• []()

测试代码:
[Jianky's blog](https://jiankychen.github.io/)

测试结果:
Jianky's blog

# 插入图片

语句

• ![]()

测试代码:
![Jianky](_data/iamges/avatar.jpg)

测试结果:

# 注释

语句

• [//]:
• [comment]:
• [^_^]:

测试代码

a

[//]: b

[comment]: c

d

[//]: <> (This is also a comment.)

[//]: # (This may be the most platform independent comment)

e

[comment]: <> (This is a comment, it will not be included)

[^_^]: 注意这里要另起一行，整体缩进
    commentted-out contents
    should be shift to right by four spaces (`>>`).

g

测试结果

a

d

e

g

# 转义字符

参考：

• markdown 转移字符
• HTML 转义字符

# 绘制流程图

VScode 可借助插件 Markdown Preview Mermaid Support 实现流程图

流程图方向：

• TB ：top bottom - 从上到下
• BT ：bottom top - 从下到上
• RL ：right left - 从右到左
• LR ：left right - 从左到右
• TD ：等同于 TB

流程块形状：

• [] ：方形
• () ：圆角
• (()) ：圆形
• {} ：菱形
• {{}} ：六角形
• [\\] ：平行四边形
• [//] ：平行四边形

连接线样式：

• --> ：有向箭头
• --- ：无向连接线
• -.- ：虚线
• === ：加粗线条

测试代码 1

```mermaid
graph LR;
    A --> B;
    B --> X;
    X --> C;
```

测试结果 1

测试代码 2

```mermaid
graph LR
    1[A] --> 2(B) --- 3((C)) -.- 4[/D/]
```

测试结果 2

利用 Markdown Preview Mermaid Support 插件画流程图

绘制流程图的语法

除 Mermaid 流程图外，也可以通过 Flowchart 的方式绘制流程图

注意，hexo 默认不支持 Flowchart 和 merimaid 流程图，需要安装插件，具体可参考 Hexo 引入 Mermaid

shoka 主题对于流程图 mermaid 的支持暂时因 puppeteer 插件而无法正常显示，具体可见 multi-markdown-it 安装与配置

# 参考资料

markdown demo

编辑器测评

编辑器推荐：vscode，Joplin，Typora，sublime，Moeditor

Create slide deck written in Marp Markdown on VS Code.