如何让 Jekyll 中 HTML 文件支持 Markdown 解析

经验笔记
浏览 loading

通过 capture 方法让 HTML 也支持 Markdown 解析。

我们在使用 Jekyll 过程中，有时候可能会创建一些 HTML 文件，但是在写一些内容时可能「更喜欢喝习惯使用 Markdown 书写」，因为用 Markdown 会更方便、快捷，如果用 HTML 书写相同的内容就需要写很多 HTML 标签，特别麻烦。

一、配置 YAML 头信息 （必须）

  • 可以是任意内容
  • 必须要有，但是里面的配置不一定是要使用
  • 如果不指定模板可以是为空的 layout
1
2
3
---
layout: 
---

二、创建 capture（必须）

  • 创建的 capture 内容是可以重复使用的
  • 将你的 Markdown 内容包含在 capture 中
  • markdown_help 是 capture 的命名，用来引用的，可以自定义
  • capture 的内容不会直接输出，可以放在任意位置，是文档前面或者引用前面
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{% capture markdown_help %}
## 包括的功能

- 自定义单元格背景色，预设多种颜色
- 指定高亮列，预设多种颜色
- 悬浮当前行，透明色
- 黑色边框

## 使用方法

- 样式见 `/* 相关样式 */`
- class 选择器见 table 标签

***

 

{% endcapture %}

三、使用 markdownify 输出 capture 引用内容

  • 引用的 markdown_help 名称要和 capture 使用的保持一致
1
{{ markdown_help | markdownify }}

Relay Tips: 一极乐（ https://yijile.com/log/492/ ）