使用小书匠写 MarkDown 文档 Hexo 博客

小书匠是一个功(zhong)能(liang)强(ji)大的 MarkDown 文档编辑器,除了支持常规的 MarkDown 语法,还要很多扩展语法(代码高亮 ,gfm ,脚注 ,上标 ,下标 ,文字高亮 ,注音 ruby ,缩写定义 ,表格 ,emoji 表情 ,文字插入 ,文字居中 ,todo ,视频 ,音频 ,附件 ,属性 ,表格 ,合并单元格式表格 ,mathjax 数学公式 ,plantuml uml 图 ,mermaid 时序图,流程图,甘特图等 ,sequence 时序图 ,codeChunks 代码块执行 ,wavedrom ,nunjucks ,plot 统计图),多种编辑器,主题,以及自定义CSS等功能,支持印象笔记、Github、Dropbox 等,以及常见的各种图床。功能详见官网

轻量级的需求可以直接在官网上用在线版的就可以了,要想获取完整的体验还是需要下载客户端,全平台支持的(nwjs 开发的),非开源,其 Github 只是提 Issue 用的。

模板配置

很久没写博客了,因为之前的一次大版本升级导致小书匠的配置文件丢了(捂脸)。

主要是有一个新建文件的模板配置,下面是我使用的适用于 Hexo 博客的模板(左上角Logo->模板)

1
2
3
4
5
6
7
8
9
10
11
---
title: 未命名文件
date: <% print(moment().format('YYYY-MM-DD hh:mm:ss')); %>
tags:
-
categories:
-
---


<!-- more -->

<!-- more --> 前面的文字可以显示在文章列表页面,后面的文字则需要阅读全文。不同的 Hexo 主题的处理也可能有区别,我用的 Next 主题。

刚刚更新了最新 5.6 版,把模板功能单独拿出来,现在可以配置多模板,支持导入导出,内置了时间函数,之前用 JavaScript 写的时间又臭又长

图片路径问题

还有一个问题是 hexo 的图片,通常我是使用相对地址的,写成 ![title](/images/xxx.png) ,但是由于 Hexo 的图片并不在 _post 目录下,此时需要做一个软连接,Windows 命令:

mklink /j "D:\hexo\source\_posts\images" "D:\hexo\source\images"

本来小书匠的设置里面有个资源绝对路径起始地址,但是默认不支持本地绑定的文件,我向作者提了这个问题,作者很快加了一个功能,可以在本地绑定设置使用全局资源查找策略,这样就不需要设置软连接了。

之所以没有使用图床,两方面原因:

  • 图床的安全性,万一哪天倒闭了呢?参见多说等
  • 博客里面的图片不多。

缺点

优点太多了,就不说了,我主要用来写博客和印象笔记。

  • 功能太多,显得有些臃肿,有一些我认为比较多余的动画效果。
  • 闭源,作者更新还是很勤快的,处理问题也很及时友好。
  • 现在也出了会员,倒是不贵,20一年,没看出来有什么用,不支持多端同步配置。
  • 和印象笔记不完全兼容,这个应该是很难解决的,毕竟印象笔记是 HTML 格式?很难转换到 MarkDown,只能重新写。
如果你不是非常有钱,请不要捐赠,土豪随意