Markdown Collect

Writing
4.5k words

结合Markdown和Hexo特性的一篇写作指南

注意：根据Markdown处理器或编辑器的不同，部分Markdown语法无法生效，但下面的部分仍会进行列举

标题Title

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题
==========
使用1个以上=号


二级标题
----------
使用1个以上-号

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

一级标题

二级标题


段落Paragrapgh

1
2
3
段落1，下面是空白行，

段落2，用于分隔段落

段落1，下面是空白行，

段落2，用于分隔段落

换行Line Break

1
2
3
我使用两个空格  换行

我使用<br>换行

我使用两个空格 换行

我使用
换行

强调Bold & Italic

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
__粗体__
**粗体**

需加粗一个单词或短语的中间部分时使用 **
粗**体**

_斜体_
*斜体*
需斜体一个单词或短语的中间部分时使用 *
斜*体*

___同时使用粗体和斜体___
***同时使用粗体和斜体***
同上对于一个单词或短语的中间部分时使用***
粗***体和斜***体

粗体
粗体
粗体

斜体
斜体
斜体

同时使用粗体和斜体
同时使用粗体和斜体
粗体和斜体

引用Quote

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
>这是一段引用
>
>同样使用空行创建段落

>下面是嵌套的引用
>>在嵌套了
>>>在嵌套嵌套了

引用中使用其他Markdown格式元素
> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.

这是一段引用

同样使用空行创建段落

下面是嵌套的引用

在嵌套了

在嵌套嵌套了

The quarterly results look great!

  • Revenue was off the chart.
  • Profits were higher than ever.

Everything is going according to plan.

列表List

1
2
3
4
5
6
7
8
9
10
11
12
13
14
有序列表
1. 项目一
2. 项目二
3. 项目三

无序列表，使用 - 或 + 或 *
- 变形太刀
- 折叠太刀

* 充能太刀
* 带盾太刀

+ 演奏太刀
+ 飞天太刀

有序列表

  1. 项目一
  2. 项目二
  3. 项目三

无序列表

  • 变形太刀
  • 折叠太刀
  • 充能太刀
  • 带盾太刀
  • 演奏太刀
  • 飞天太刀

代码Code

使用 `
git clone

要在代码段中使用`时,使用 ``
Use `code` in your markdown

代码块

  1. 行缩进四个空格或一个制表符
    System.out.println(“hello world”);

  2. 围栏，使用3个 ` 或 ~，指定使用的语言来添加语法高亮，例如 ```java

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    /**
     * 文件列表
     */
    @GetMapping("/fileList")
    public ResponseVo loadFileList(HttpSession session, @RequestBody FileQueryDto fileQueryDto) {
        UserSessionDto userSessionDto = (UserSessionDto) session.getAttribute(Constants.SESSION_USER_KEY);
        fileQueryDto.setUserId(userSessionDto.getUserId());
        fileQueryDto.setDelFlag(FileDelFlagEnum.CLOUD.getDelFlag());
        return getSuccessResponseVo(userFileService.loadFileListByPage(fileQueryDto));
    }

分隔线Horizontal Rule

1
2
3
4
5
6
7
8
9
3个以上的 \* 或 \- 或 \_
为了兼容性，请在分隔线的前后均添加空白行

***

---

___


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
#### 超链接

链接title可选
[超链接显示名](超链接地址 "超链接title")

[HigeNeko Blog](http://www.higeneko.site/ "这是本博客地址")

#### 网址或Email地址
<https://mvnrepository.com/>
<fake@example.com>

#### 格式化链接

使用强调语法
This is **[Bold Link !](example.com.bold)**

将链接表示为代码
This is [`code link`](example.com.code)

#### 引用
[hobbit-hole][1]

[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"

#### 文内跳转
[跳转到##链接Link](#链接link)

超链接

链接title可选
超链接显示名

HigeNeko Blog

网址或Email地址

https://mvnrepository.com/
fake@example.com

格式化链接

使用强调语法
This is Bold Link !

将链接表示为代码
This is code link

引用

hobbit-hole

文内跳转

跳转到##链接Link

图片Img

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
类似链接，前面加上!
![图片alt](图片链接 "图片title")

Hexo打开文章资源文件夹功能后，
如果通过使用相对路径的常规 markdown 语法，
它将不会出现在首页上
![图片不存在](<Markdown Collect/example.jpg> "图片title")

上面的示例中同样展示了文件路径存在空格时，可以使用的解决办法

#### 使用相对路径引用的标签插件(Hexo)
{% asset_img example.jpg This is a example image %}
路径存在空格时使用"包围

#### 使用 Markdown 嵌入图片(Hexo)
需开启下面配置
post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true
![图片不存在](example.jpg "This is a example image")

类似链接，前面加上!
图片alt

Hexo打开文章资源文件夹功能后，
如果通过使用相对路径的常规 markdown 语法，
它将不会出现在首页上
图片不存在

使用相对路径引用的标签插件(Hexo)

使用 Markdown 嵌入图片(Hexo)

需开启下面配置
post_asset_folder: true
marked:
prependRoot: true
postAsset: true
图片不存在

调整图片的大小

使用HTML
1
2
3
![图片不存在](example.jpg =300x300 "This is a example image")
<img src="example.jpg" width=70%>
<img src="example.jpg" width=300 height=300>

![图片不存在](example.jpg =300x300 “This is a example image”)

标签插件（Hexo）
1
2
3
{% img [class names] /path/to/image [width] [height] '"title text" "alt text"' %}
上面这个不太好用，路径不加/时，会认作[class names]
{% asset_img example.jpg 600 200 %}

转义字符Escape

1
2
\- a
- a

- a

  • a

内嵌HTML标签

1
2
<font color=orange size=4>注意！！！</font>
<font color=#0000FF size=6>注意！！！</font>

注意！！！
注意！！！

表格Table

一般使用工具生成Markdown表格

1
2
3
4
5
6
7
8
9
10
| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

左、右对齐，居中
| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |
SyntaxDescription
HeaderTitle
ParagraphText

左、右对齐，居中

SyntaxDescriptionTest Text
HeaderTitleHere’s this
ParagraphTextAnd more

折叠内容Fold

1
2
3
4
<details>
<summary>点击展开</summary>
被折叠的内容
</details>

注意：在折叠内容里使用markdown需要先空行

点击展开被折叠的内容

删除线Delete Line

1
~~不是删除线~~

不是删除线

任务列表Task

1
2
- [x] 添加使用样例
- [ ] 更新网站内容
  • 添加使用样例
  • 文章概述调整
  • 更新网站内容

表情符号Emoji

1
2
3
4
复制黏贴
😂
使用表情符号简码
:tent:

😂
:tent:

该注意的点

使用hexo generate报错

1
2
ERROR Process failed: _posts/DDD框架.md
ValidationError: `null` is not a string!

博客文章中存在某些属性没有填写，为空（null）
例如excerpt:(文章概要)

解决方法

  1. 填写缺失的属性，不需要时则删掉对应的属性

多个空行

空行在markdown里是用来区分段落的，
连续使用多个空行，也只是分隔成两个段落，不能实现多个空行的效果

markdown

1
2
3
4
5
6
7
111





222

显示效果
111

222

要使用多个空行时，用<br>

1
2
3
4
5
6
7
8
例1
111<br><br>
222

例2
111
<br>
222

例1
111


222

例2
111


222

例1和例2效果一样都空了2行