将Obsidian适配到jekyll的注意项

文件名

文件名中不建议使用标点,作为直接索引项时可能被错误转义导致404。想用的话可以尝试一下,万一可行呢?(试试就逝世)

Front Matter

笔记建议(必须)有以下front matter(怎么会有笔记没有呢)

  1. title1
  2. date2

图片

obsidian中使用的形如[文件名|尺寸]的形式暂未得到处理,大致判断是|使用问题,无法显示图片,修缮动机不充足,禁用。

Tag

聚点(roots)中罗列的是标签包含rootnote的笔记,作为传统一级标题的变体,建议为某类笔记的起点篇添加rootnote作为探索的入口,显示到聚点

公式

在obsidan中显示正常的公式在转换为html后有一(小)部分可能不能很好的得到渲染,这出于一些我不想研究的缺陷。当本地测试行内公式无法得到渲染时可以尝试使用行间公式

语法兼容

raw 标记临时禁止处理其所包围的代码。如果输出的内容与 Liquid 模板语言有冲突时可以避免冲突。
输入
Imgur
输出
Imgur

  1. 不得为2011-12-13等的纯日期时间(数字)格式,网页中罗列的标题默认是title而不是文件名 

  2. 文件的创建时间;建议格式为YYYY-MM-DDTHH:mm:ss+08:00d 

BackLink

BuyMeACoffee