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

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

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

一、配置 YAML 头信息 (必须)

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

二、创建 capture(必须)

  • 创建的 capture 内容是可以重复使用的
  • 将你的 Markdown 内容包含在 capture 中
  • markdown_help 是 capture 的命名,用来引用的,可以自定义
  • capture 的内容不会直接输出,可以放在任意位置,是文档前面或者引用前面
{% capture markdown_help %}
## 包括的功能

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

## 使用方法

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

***

 

{% endcapture %}

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

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

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