Obsidian 自定义插件介绍
插件下载
https://gtjs-9gjbu0mx.maozi.io/ruanjian/hexogeshi.zip
https://gtjs-9gjbu0mx.maozi.io/ruanjian/ai-image-generator.zip
https://gtjs-9gjbu0mx.maozi.io/ruanjian/douyingeshihua.zip
在弹出的界面中,找到下载按钮,点击下载。
1. Hexo 格式转换插件
插件原理
Hexo 格式转换插件(hexogeshi)是一个用于将 Obsidian 笔记转换为符合 Hexo 博客格式的工具。其核心功能包括:
-
图片处理:
- 提取文档中的所有
![[图片路径]]格式引用 - 创建与文档同名的文件夹,用于存放图片
- 将图片移动到同名文件夹(如果不在其中)
- 将图片引用转换为
格式
- 提取文档中的所有
-
YAML 前置元数据处理:
- 检查文档是否有 YAML 前置元数据
- 如果没有,自动添加包含 title、date 和 categories 字段的 YAML 元数据
- 日期格式化为
YYYY-MM-DD HH:MM:SS格式 - categories 字段自动填充为父级目录名称
-
用户界面:
- 在 Obsidian 左侧添加 "转换为 Hexo 格式" 按钮
- 在命令面板中添加 "转换当前笔记为 Hexo 格式" 命令
使用教程
-
安装插件:
- 将
hexogeshi文件夹复制到 Obsidian 的插件目录.obsidian/plugins/ - 重启 Obsidian
- 在设置 → 社区插件中启用 "Hexo 格式转换"
- 将
-
使用方法:
- 打开需要转换的 Markdown 文档
- 点击左侧的 "转换为 Hexo 格式" 按钮,或在命令面板中执行 "转换当前笔记为 Hexo 格式" 命令
- 插件会自动处理图片并添加 YAML 前置元数据
- 转换完成后,文档会被自动更新为 Hexo 格式
-
注意事项:
- 插件会直接修改当前文档,建议在转换前备份重要文档
- 图片会被移动到与文档同名的文件夹中
- 转换后的文档可以直接复制到 Hexo 博客的
source/_posts目录
2. AI 图片生成器插件
插件原理
AI 图片生成器插件(ai-image-generator)是一个利用 SiliconFlow API 生成与文档相关的 AI 图片的工具。其核心功能包括:
-
图片生成:
- 使用当前文档名称作为 AI 生成的提示词(prompt)
- 调用 SiliconFlow API 生成图片
- 下载生成的图片到用户指定的路径
-
YAML 前置元数据更新:
- 自动更新文档的 YAML 前置元数据,添加或更新
img字段 img字段格式为/images/图片名称.jpg- 如果文档没有 YAML 前置元数据,自动创建一个
- 自动更新文档的 YAML 前置元数据,添加或更新
-
用户设置:
- 在设置界面中允许用户输入 SiliconFlow API Key
- 允许用户指定图片保存路径
- 允许用户选择图片尺寸(1280x960、1024x1024、768x1024、1024x768)
-
用户界面:
- 在 Obsidian 左侧添加 "生成AI图片" 按钮
- 在命令面板中添加 "生成AI图片" 命令
使用教程
-
安装插件:
- 将
ai-image-generator文件夹复制到 Obsidian 的插件目录.obsidian/plugins/ - 重启 Obsidian
- 在设置 → 社区插件中启用 "AI 图片生成器"
- 将
-
配置插件:
- 打开 Obsidian 设置 → AI 图片生成器设置
- 填入 SiliconFlow API Key(需要在 SiliconFlow 官网注册获取)
- 填入图片保存路径,例如:
D:/blog/source/images - 选择所需的图片尺寸
-
使用方法:
- 打开需要生成图片的 Markdown 文档
- 点击左侧的 "生成AI图片" 按钮,或在命令面板中执行 "生成AI图片" 命令
- 等待图片生成完成(可能需要几十秒)
- 图片生成成功后,插件会自动下载图片并更新文档的 YAML 前置元数据
-
注意事项:
- 生成图片需要联网,并且会消耗 SiliconFlow API 配额
- 生成的图片名称为文档前10个字加上
.jpg后缀 - 插件会自动更新文档的 YAML 前置元数据,添加
img字段指向生成的图片
3. 抖音卡片格式化
插件原理
抖音卡片格式化插件(douyingeshihua)是一个用于将抖音分享内容转换为 Hexo 博客支持的抖音卡片格式的工具。其核心功能包括:
-
内容解析:
- 识别选中内容中的抖音分享链接(
https://v.douyin.com/...) - 自动提取标题和描述信息
- 清理推广文字和无意义字符
- 识别选中内容中的抖音分享链接(
-
格式转换:
- 将抖音分享内容转换为 Hexo 支持的抖音卡片标签格式
- 生成
{% douyin 标题 链接 %}` 和 `{% enddouyin %}包裹的格式 - 支持批量转换多个抖音分享链接
-
用户界面:
- 在 Obsidian 左侧添加 "转换选中内容为抖音卡片格式" 按钮
- 在命令面板中添加 "转换选中内容为抖音卡片格式" 命令
使用教程
-
安装插件:
- 将
douyingeshihua文件夹复制到 Obsidian 的插件目录.obsidian/plugins/ - 重启 Obsidian
- 在设置 → 社区插件中启用 "抖音卡片转换"
- 将
-
使用方法:
- 复制抖音分享内容到 Obsidian 编辑器中
- 选中要转换的抖音分享内容
- 点击左侧的 "转换选中内容为抖音卡片格式" 按钮,或在命令面板中执行 "转换选中内容为抖音卡片格式" 命令
- 插件会自动将选中内容转换为抖音卡片格式
-
示例:
输入内容:
这是一个有趣的视频
https://v.douyin.com/xxx
复制此链接,打开Dou音搜索,直接观看视频!
转换后:
{% douyin 这是一个有趣的视频 https://v.douyin.com/xxx %}
{% enddouyin %}
总结
这三个插件为 Obsidian 用户提供了便捷的工具,帮助他们更轻松地将笔记转换为 Hexo 博客格式、生成相关的 AI 图片以及转换抖音分享内容。通过简单的点击操作,用户可以快速完成文档格式转换、图片生成和抖音卡片格式化,提高博客写作效率。
如果您在使用过程中遇到任何问题,可以检查插件的控制台输出,或者查看插件的源代码进行调试。