Cookies Used! Some utilities (google analitics, adsense) on this site used cookies
初步使用 markdeep 在 hugo 中撰写文档
最近对 markdeep 产生了些兴趣,感觉蛮好玩的,就想着能不能把 markdeep 集成到 hugo
中去,于是就有了这篇
最近对 markdeep 产生了些兴趣,感觉蛮好玩的,就想着能不能把 markdeep 集成到 hugo
中去,于是就有了这篇
## 情况说明
本文用到了以下工具:
| 名称 | 用途 | 版本 |
| -------- | ---------------------- | -------- |
| hugo | 静态网站生成器 | v0.123.7 |
| markdeep | markdown 文档转成 html | 1.16 |
| VSCode | md/html 编辑器 | 1.87.0 |
两位老朋友,加上一位新朋友 [markdeep](https://casual-effects.com/markdeep/),
这个工具很有意思,基本上你只要给你的 md 文件加上这么一个尾巴:
```html
```
你的 markdown 文件就瞬间变成了一个网页,可以改名 html 后在浏览器打开了,
是不是很神奇?这是 markdeep 吸引我的一个地方,另一个地方在于,它可以用 ASCII
字符画图:
**************************************************************
*
* .---. .-. .-. .-.
* | A +----->| 1 +<---->| 2 |<----+ 4 +------------------.
* '---' '-' '+' '-' |
* | ^ |
* v | v
* .-. .-+-. .-. .-+-.
* | 3 +---->| B |<----->| 5 +---->| C |
* '-' '---' '-' '---'
**************************************************************
这么一张图,其实是这样敲出来的:
```txt
**************************************************************
*
* .---. .-. .-. .-.
* | A +----->| 1 +<---->| 2 |<----+ 4 +------------------.
* '---' '-' '+' '-' |
* | ^ |
* v | v
* .-. .-+-. .-. .-+-.
* | 3 +---->| B |<----->| 5 +---->| C |
* '-' '---' '-' '---'
**************************************************************
```
这就让人很心动了,这也是 markdeep 命名的由来,它想比 down 更深一点,
于是我就在想,我的博客现在基本上大部分文章也都是 markdown 格式的,
markdown 格式我也比较熟了,那么能不能用 markdeep 来将 markdown 转为网页,再由
hugo 来统筹整个页面呢?
简单搜索了一下,相关的材料似乎不多,看来是要自己吃螃蟹了,不过我很快就有了思路。
## 思路
我们现在知道了,markdeep 的文档,说白了也就是一个 html 文件,而 hugo 本来也支持
直接管理 html 资源,那其实我们可以直接用 hugo 新建一个 html 文档,然后用
markdown 的格式撰写内容,最后加上 markdeep 的依赖就可以了。
试了一下这个思路是可行的,但是有不少问题,所以接下来我们要把这些问题一一解决掉,
达到一个可用的状态。
## 问题解决
### 1. 帖子只是 html 文档的一部分
hugo 有一个 single.html 的模板,实际的单一网页是按照这个模板定义的内容显示的,
而我们日常写的帖子也是转化为这个模板的一部分,然后输出为完整的网页样式。那么这一
点就和 markdeep 的全文 markdown 模式有冲突了,除非我们打算用 `