원클릭으로
obsidian-to-blog
将 Obsidian Clippings/笔记发布为 Hugo 博客文章。自动转换 frontmatter、处理图片链接、创建标准目录结构。使用方式:"发布 Obsidian 文章到博客" 或提供 obsidian:// URL。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
将 Obsidian Clippings/笔记发布为 Hugo 博客文章。自动转换 frontmatter、处理图片链接、创建标准目录结构。使用方式:"发布 Obsidian 文章到博客" 或提供 obsidian:// URL。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | obsidian-to-blog |
| description | 将 Obsidian Clippings/笔记发布为 Hugo 博客文章。自动转换 frontmatter、处理图片链接、创建标准目录结构。使用方式:"发布 Obsidian 文章到博客" 或提供 obsidian:// URL。 |
将 Obsidian vault 中的文章(Clippings 或笔记)转换并发布为 Hugo 博客文章。
当用户提到以下任意内容时使用此 skill:
obsidian:// URL| 配置项 | 值 |
|---|---|
| Obsidian Vault 路径 | D:\Obsidian\lilinji |
| Hugo 博客根目录 | D:\lilinji.github.io |
| 文章目录 | content/posts/ |
| 作者 | Ringi Lee |
| 默认标签 | 用户指定,常见:AI相关 |
| HTTP 代理 | http://127.0.0.1:10808(用于下载境外图片) |
从用户输入中提取以下信息:
文章路径:
obsidian:// URL,解码得到文件路径
obsidian://open?vault=lilinji&file=Clippings%2F文章名D:\Obsidian\lilinji\Clippings\文章名.md标签:用户指定的标签(如 "AI相关")
Draft 状态:默认 false(直接发布),用户可指定 draft: true
使用 view_file 读取源文章内容。
Obsidian 文章典型 frontmatter:
---
title: "文章标题"
source: "https://原文链接"
author:
- "[[@作者名]]"
published: 2026-04-06
created: 2026-04-08
description: "文章描述..."
tags:
- "clippings"
---
将 Obsidian frontmatter 转换为 Hugo PaperMod 格式:
---
title: "文章标题" # 保持不变
date: 2026-04-08T09:00:00+08:00 # 使用当前时间,ISO 8601 格式
draft: false # 默认发布
tags: # 使用用户指定的标签
- AI相关
author: Ringi Lee # 固定作者
showToc: true # 显示目录
tocOpen: false # 目录默认收起
---
转换规则:
| Obsidian 字段 | Hugo 字段 | 处理方式 |
|---|---|---|
title | title | 保持不变 |
source | 正文添加原文来源 | 转为 > 原文来源:[链接](URL) |
author | 正文可选添加作者 | 清理 [[@xxx]] 格式 |
published | 参考 | 可用于 date |
created | 忽略 | 使用当前时间 |
description | 可选 summary | 如需要可添加 |
tags: clippings | 替换 | 使用用户指定标签 |
图片处理:
)→ 优先通过代理下载到本地 images/ 目录,然后替换为本地引用 。下载失败时保留原始 URL。)→ 复制图片到博客文章目录,保持相对引用![[image.png]])→ 转换为标准 markdown  并复制文件代理下载远程图片步骤:
a. 在文章目录下创建 images/ 子目录:
mkdir -p "content/posts/YYYY-MM-DD-slug/images"
b. 为每张远程图片取一个描述性文件名(如 featured.jpg、turn-based.jpg),用 curl 通过代理下载:
curl -x http://127.0.0.1:10808 -sL "https://远程图片URL" \
-o "content/posts/YYYY-MM-DD-slug/images/文件名.jpg"
c. 并行下载多张图片以提高效率(多个 curl 同时运行)。
d. 将文章中对应该图片的引用从远程 URL 替换为本地路径:
<!-- 替换前 -->

<!-- 替换后 -->

e. 如果某张图片下载失败(超时或 404),保留原始远程 URL 不做替换。
Obsidian 语法清理:
[[@username]] → @username 或保持为文本[[内部链接]] → 纯文本或移除双括号==高亮== → **高亮**(Hugo 不支持 ==)> blockquote)代码块:保持不变
描述中的 blockquote:如果 Obsidian description 长,可作为文章开头引用块
目录命名:YYYY-MM-DD-slug
-文件:content/posts/YYYY-MM-DD-slug/index.md
本地图片:如有,复制到同目录下
content/posts/2026-04-08-搞懂缓存机制从Gemma4到Claude-Code省80Token/
├── index.md
└── (可选的本地图片文件)
运行以下命令验证文章可以正确渲染:
# 在博客根目录执行
hugo server -D
检查项:
输入标题: "搞懂缓存机制,从Gemma4到Claude Code省80%Token"
处理步骤:
1. 移除标点符号(,。!?;:""'')
2. 空格替换为 -
3. 保留中文、英文、数字、-
4. 多个连续 - 合并为一个
5. 去掉首尾 -
输出 slug: "搞懂缓存机制从Gemma4到Claude-Code省80Token"
obsidian://open?vault=lilinji&file=Clippings%2F搞懂缓存机制...
标签 AI相关
✅ 文章已创建: content/posts/2026-04-08-搞懂缓存机制从Gemma4到Claude-Code省80Token/index.md
标题: 搞懂缓存机制,从Gemma4到Claude Code省80%Token
标签: AI相关
图片: 3 张(已通过代理下载到 images/ 目录)
下一步:
1. hugo server -D 预览
2. 确认后 deploy
2026-04-08T09:00:00+08:00)& 不需要转义[[]] 语法,必须转换