概述

Markdown 的目标是实现「易读易写」。

可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。

Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 [Setext]、[atx]、[Textile]、[reStructuredText]、[Grutatext] 和 [EtText],而最大灵感来源其实是纯文本电子邮件的格式。

语法

标题

类 Setext 形式是用底线的形式,利用 ===--- 表示一级标题和二级标题

一 级 标 题
==========
二 级 标 题
----------

类 Atx 形式是在行首插入 1 到 6 个 # ,来对应一级到六级的标题

# 一 级 标 题
## 二 级 标 题
### 三 级 标 题

引用

在行首加入>表示区块引用,可嵌套

> 这是第一行引用
>> 这是第二行引用
>>> 这是第三行引用

直接使用一个制表符或者4个空格表示引用

	这是第一行
	这是第二行

列表

无序列表使用 + - * 作为列表标记

+ Red
+ Green
+ Blue

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

1. Red
2. Green
3. Blue

分割线

三个以上的 * -

****
---------

强调

* _ 包围需要强调的内容,必须闭合

* 强调 *
-- 强调 --

链接

使用 中括号+小括号 表示,其中中括号表示链接显示的文字,小括号中的为链接URL

[我是一个链接](https://google.com)

图片

使用 惊叹号+中括号+小括号 表示,其中中括号表示没有图片时显示的文字,小括号中的为图片URL

![我是一个图片](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png)

代码

行内代码使用一对反引号` ` 表示

行间代码使用三对连续反引号 ``` ```表示

`我是代码`

emoji表情

markdown的emoji表情,可以用冒号包围的一串代码来表示。

但是原生的hexo并不能解析诸如:smile:的emoji表情,这是markdown 渲染引擎的问题。

将 markdown 变成 html 的转换器叫做markdown渲染器 。

Hexo默认是采用 hexo-renderer-marked 渲染器,它并不支持emoji插件扩展(甚至其他的插件也不可以)

这里我们改用 hexo-renderer-markdown-it渲染器,使用 markwon-it-emoji 插件来支持emoji。

操作步骤

  1. 进入博客根目录
  2. 执行 npm un hexo-renderer-marked --save 卸载旧的渲染器
  3. 执行npm i hexo-renderer-markdown-it --save 安装新的渲染器
  4. 执行 npm install markdown-it-emoji --save 安装emoji插件拓展
  5. 配置站点_config.yml文件,在最后添加如下代码即可

1
2
3
4
5
6
7
markdown:
plugins:
- markdown-it-footnote
- markdown-it-sup
- markdown-it-sub
- markdown-it-abbr
- markdown-it-emoji

点击查看常用emoji代码