Memorykk

never too late to learn

Markdown

Markdown是一种轻量级标记语言，以纯文本格式快速编写文档。

  • Markdown编写的文档后缀为 .md、.markdown，可以导出HTML、Word、图像、PDF、Epub等多种格式的文档。
  • Hexo、github等支持使用markdown编辑器编写文章，刚好边学边练。
  • 可以通过css的方式，美化Hexo元素，嵌入style 标签，在生成html时，style标签也随之写入到html页面中，产生自定义效果。

目录

Markdown语法

标题

使用#标记标题，1-6个#标识1-6级标题。
（markdown语法中的关键字之后一般要加一个空格）
示例：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

字体

  • 斜体
    使用一个*包起来
  • 加粗
    使用两个*包起来
  • 斜体加粗
    使用三个*包起来
  • 删除线
    使用两个~包起来
  • 下划线
    使用HTML的<u></u>包起来

示例：

*这是倾斜的文字*
**这是加粗的文字**
***这是斜体加粗的文字***
~~这是加删除线的文字~~
<u>这是加下划线的文字</u>

效果如下：
这是倾斜的文字
这是加粗的文字
这是斜体加粗的文字
这是加删除线的文字
这是加下划线的文字

换行

markdown源文件中的回车不会换行，必须使用两个空格+回车或者两个回车。

示例 （注意第一段之后的空格）：

第一段  
第二段

第三段

效果如下：

第一段
第二段

第三段

分隔线

在一行中用三个以上的*、-、_来建分隔线，显示效果一致，行内不能有其他东西，但可以在行内插入空格。

示例：

***
---
___

效果如下：

脚注

！貌似无法使用
脚注是对文本的补充说明，鼠标悬停即可查看，使用[^要注明的文本]，在之后任意位置重复[^要注明的文本]:补充内容。

示例：

Welcome To [^Memorykk's Blog]
[^Memorykk's Blog]: https://memorykk.cn

效果如下：
Welcome To [^ Memorykk ]
[^ Memorykk ]: https://memorykk.cn
参考：参考示例

列表

无序列表

无序列表使用*、+、-标记，追加列表内容，三者无差异。

示例：

* 第一项
+ 第二项
- 第三项

效果如下：

  • 第一项
  • 第二项
  • 第三项

有序列表

有序列表使用数字+.标记。

示例：

1. 第一项
2. 第二项

效果如下：

  1. 第一项
  2. 第二项

嵌套列表

子列表的选项前加四个空格即可。

示例：

1. 第一项
    * 元素1
    * 元素2
2. 第二项
    - 元素3
    - 元素4

效果如下：

  1. 第一项
    • 元素1
    • 元素2
  2. 第二项
    • 元素3
    • 元素4

区块

区块使用>标记，追加区块内容。
区块支持嵌套，一个>为最外层，两个>为第一层嵌套，以此类推。
另外，区块可与列表等随意嵌套。

> 1. 第一项
>     * 元素1
>     * 元素2
2. 第二项
    > - 元素3
    > - 元素4

效果如下：

  1. 第一项
    • 元素1
    • 元素2
  2. 第二项
    • 元素3
    • 元素4

代码

单行代码

使用一个`将代码包起来。

`System.out.println("Hello World!");`

效果如下：
System.out.println("Hello World!");

多行代码

使用六个`将代码包起来，前三个`接代码语言，也可不指定。

示例：（为了防止编辑器转义，在前后加了前后括号，实际使用中不能写哦~）

（```java
System.out.println("Hello");
System.out.println("World");
System.out.println("!");
```）

效果如下：

System.out.println("Hello");
System.out.println("World");
System.out.println("!");

链接

普通链接

使用[链接名称](链接地址)或者直接<链接地址>标记。

[Memorykk's Blog](https://memorykk.cn)  
<https://www.memorykkk.cn>

效果如下：
Memorykk’s Blog
https://www.memorykkk.cn

高级链接

通过变量来设置一个链接，变量赋值在文档末尾。

这个链接赋给变量1：[Memorykk's Blog][1]
这个链接赋给变量google：[GOOGLE][google]

[1]: https://memorykk.cn
[google]: https://www.google.com

效果如下：
这个链接赋给变量1：Memorykk’s Blog
这个链接赋给变量google：GOOGLE

图片

使用![alt文本](图片链接 "可选标题")标记。
markdown不支持指定宽高，可使用HTML <img>标签标记。
可以制作图片链接

示例：

![Github.ico](https://github.githubassets.com/favicons/favicon.svg)

效果如下：
Github.ico

表格

使用|标记单元格，使用-分隔表头和其他行，还可设置对其方式：

  • -:设置内容和标题栏居右对齐。
  • :-设置内容和标题栏居左对齐。
  • :-:设置内容和标题栏居中对齐。
  • :之间多余的空格会被忽略
  • 的数量至少一个
  • 内容和|之间多余的空格会被忽略

示例：（但是本页并未生效，Hexo的问题？）

| 左对齐 | 右对齐 | 居中对齐 |
| :------| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单 | 单 | 单 |

效果如下：

table.PNG

支持的HTML元素

直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等。

转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符反斜杠\。
目前支持的特殊字符：
\、`、*、_、{}、[]、()、#、+、-、.、!、HTML元素。

公式

使用两个$包裹 TeX 或 LaTeX 格式的数学公式。
提交后会根据需要加载 Mathjax 对数学公式进行渲染。

示例：

$$
\lim_{x \to 0} \frac{3x^2 +7x^3}{x^2 +5x^4} = 3
$$

效果如下：
$$
\lim_{x \to 0} \frac{3x^2 +7x^3}{x^2 +5x^4} = 3
$$

画图

参考 菜鸟教程

Markdown工具

目前我使用的是Visual Studio Code，默认支持markdown编辑以及即时预览，配合插件十分好用：

推荐

Hexo中Markdown语法失效问题

参考资料

Tool Markdown