这篇自学笔记参考自Markdown 扩展语法

表格语法

利用管道符|分隔每列，三个以上连字符---创建标题，表格中的文字可以进行链接、代码和强调；不能是块，标题，列表，水平规则，图像和HTML标签

代码示例

1
2
3
4
| Title	| Title	|
|-------|-------|
| item  | itme 	|
| item 	| itme 	|

效果呈现

Title Title
item item
item item

Tip:使用Markdown Tables工具快速创建表格

表格的对齐

对齐在标题创建---行添加冒号:，左对齐:---、居中:---:、右对齐---:

代码示例

1
2
3
4
| Title	| Title	| Title	|
|:-------|:-------:| ------:|
| item  | itme 	| itme 	|
| item 	| itme 	| itme 	|

效果呈现

Title Title Title
item itme itme
item itme itme

管道符的转义

使用HTML代码|在表格中转义管道符|

脚注

脚注可以单击链接跳转到注释位，脚注的标识创建使用方括号[]包裹标识符，脚注部分使用该格式[^1]:text书写

代码示例

1
2
3
4
5
阿尔卡那（Arcana[^1]，也翻译作“秘仪”）,是塔罗牌(Tarot Card)的一种分类方式
在这里“愚人”们将迎来最终的审判[^judgement]
塔罗牌原先是一种广为流传的纸牌游戏，之后慢慢被用作了占卜算命。
[^1]:英文“Arcana”其实是複数形式，其单数形式爲“Arcanum”
[^judgement]:注意是“Judgement”而不是“Judgment”。

效果呈现

阿尔卡那（Arcana[1]，也翻译作“秘仪”）,是塔罗牌(Tarot Card)的一种分类方式
在这里“愚人”们将迎来最终的审判[2]
塔罗牌原先是一种广为流传的纸牌游戏，之后慢慢被用作了占卜算命。

关于脚注的注意事项

注意：hexo原本并不支持脚注，所以这也许是你看不到上文脚注的原因，安装hexo-renderer-markdown-it插件就能看见了

#卸载原有渲染器

npm un hexo-renderer-marked --save

#安装插件

npm i hexo-renderer-markdown-it --save

去到hexo根目录的 _config.yml，修改配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# Markdown-it
# https://markdown-it.github.io/markdown-it/#MarkdownIt.renderInline
markdown:
  render:
    html: true
    xhtmlOut: false
    breaks: true
    linkify: true
    typographer: true	#替换常见的排版元素
    quotes: '“”‘’'
  plugins:
    - markdown-it-abbr	#支持abbr标签
    - markdown-it-footnote	#支持脚注
    - markdown-it-ins	#支持插入标签
    - markdown-it-sub	#支持下标
    - markdown-it-sup	#支持上标
  anchors:
    level: 2	#从设置的数值到6级标题开始添加锚点
    collisionSuffix: 'v'	#ID重复时的后缀
    permalink: true	#是否在标题创建锚点标识
    permalinkClass: header-anchor
    permalinkSymbol:

参考自插件的官方hexo-renderer-markdown-it

配置文件解析参考自HEXO下的锚点标题与Emoji表情

标题锚点

要添加ID，使用大括号括起ID,添加链接的方式就可以传送到指定ID标题

代码示例

在标题处添加标题

1
# 表格语法 {#title-id}

在要链接处添加链接

1
关于表格语法你可以在 [表格语法](#title-id)查看

效果呈现

关于表格语法你可以在 表格语法查看

注意:和脚注一样同样需要加装hexo-renderer-markdown-it插件

加装后不需要大括号在标题添加ID，直接在要链接处 [你起的名](#要链接的标题全名)

删除线

在要添加删除线的前后添加波浪号~

代码示例

1
~~欢迎来到我的天鹅绒房间。~~这里是位于梦与现实，精神与物质的狭缝之处

效果呈现

欢迎来到我的天鹅绒房间这里是位于梦与现实，精神与物质的狭缝之处

任务列表

在任务列表前添加中括号[ ]和空格

hexo中使用需要加装markdown-it-checkbox，并在修改配置文件

安装插件

1
npm install markdown-it-checkbox --save

修改配置文件_config.yml

1
2
plugins:
  - markdown-it-checkbox	#启用checkbox插件

代码示例

1
2
[ ] 未勾选
[x] 已勾选

效果呈现


Emoji表情

emoji表情使用冒号:开头和结尾，中间放emoji的短代码

同样hexo需要加装插件

安装插件

1
npm install markdown-it-emoji --save

修改配置文件_config.yml

1
- markdown-it-emoji 	#启用emoji插件

代码示例

1
我想吃塔克今天:taco:

效果呈现

我想吃塔克今天🌮

Tip:可以使用这个表情符号简码列表查看emoji😆

  1. 英文“Arcana”其实是複数形式，其单数形式爲“Arcanum” ↩︎

  2. 注意是“Judgement”而不是“Judgment”。 ↩︎