Obsidian(Markdown笔记软件) 插件 + claude code skills 玩法合集:论文管理、图片优化、多格式导出一站式搞定
Obsidian是一款基于本地Markdown文件的笔记工具,具有数据安全、格式开放的特点。其核心优势在于所有笔记均为独立Markdown文件,即使软件停更也能继续使用。用户可通过GitHub实现自动同步备份,确保数据安全。Obsidian与AI工具(如Claude Code)结合可实现多种高效功能:通过Claudian插件进行笔记整理、知识图谱构建;利用Skills实现论文推荐解读、图片管理优化
文章目录
概要
Obsidian 最吸引人的一点,就是它的笔记存储方式——所有笔记本质上都是本地电脑上的独立 Markdown 文件。这意味着,哪怕 Obsidian 开发者跑路、软件停更,笔记也不会丢失,换任何一款 Markdown 编辑器(比如 VS Code、Typora)都能继续编辑使用。
为了进一步保障安全,可以搭配 GitHub 进行云端同步备份——GitHub 作为全球最大的源代码托管平台,早已成为计算机科学的基础设施,把笔记备份在上面,比存在任何云笔记、网盘都要安全稳定。
Obsidian 本身不带 AI 功能,但它的本地 Markdown 特性,让它和 AI 工具(比如 Cloud Code、Gemini CLI)成了绝配。AI 编程工具天生擅长处理本地文件,尤其是 Markdown 格式,两者结合,能玩出很多神奇的用法:
-
让 AI 帮我检索笔记、整理文件夹,省去手动分类的麻烦;
-
模仿自己的文风写笔记、写视频脚本,提高创作效率;
-
根据过往的视频/笔记思路,结合热点,生成爆款选题;
-
批量处理文件,比如批量创建选题文件夹、整理大纲。
下面所有用到的skills都已上传到github中。

| Skill | 目录 | 主要用途 | 关键输出 |
|---|---|---|---|
| start-my-day | start-my-day/ | 每日启动研究流:抓取并筛选高价值论文推荐 | 10_Daily/YYYY-MM-DD论文推荐.md、arxiv_filtered.json |
| paper-analyze | paper-analyze/ | 深度分析单篇论文,生成图文并茂的 Obsidian 笔记 | 论文分析笔记、知识图谱节点/边更新 |
| extract-paper-images | extract-paper-images/ | 从论文中提取图片(优先 arXiv 源码包) | images/、images/index.md、可引用图片路径 |
| paper-search | paper-search/ | 在已有论文笔记中按关键词/作者/标签检索 | 分组后的候选论文结果与相关性评分 |
| obsidian-markdown | obsidian-markdown/ | 规范化 Obsidian Markdown(wikilink/embed/callout/frontmatter) | 可直接在 Obsidian 渲染的 .md |
| obsidian-bases | obsidian-bases/ | 创建与编辑 Obsidian .base 数据视图 | 带 filters/formulas/views 的 .base |
| json-canvas | json-canvas/ | 创建与编辑 Obsidian .canvas 画布 | 符合 JSON Canvas 规范的 .canvas |
本文围绕 Obsidian 笔记工具展开,详细介绍其核心优势 —— 本地 Markdown 存储带来的安全稳定性,并讲解如何搭配 GitHub 实现自动同步备份;重点分享 Obsidian 与 AI 工具(Claude Code 等)的结合玩法,包括安装 Claudian 插件、配置相关技能,实现论文推荐解读、笔记结构化(Canvas 图谱)等高效功能;同时提供图片管理优化、笔记多格式导出(Word/HTML/PDF)的实操方法,最后补充双向链接与知识图谱的使用技巧,助力用户搭建高效、安全的 “第二大脑”,解锁笔记创作与知识管理的新方式。
配置 github
首先创建 GitHub 私有仓库:
github详细操作可以参考之前写过的文章:
从代码提交到远程部署:GitHub 完整操作指南(解决 SSH 连接与分支冲突)

把笔记文件夹上传到github仓库:

Obsidian 会生成一个 .obsidian 文件夹,用于存储软件配置。我们将 workspace.json 文件排除在 Git 管理之外。这个文件记录了当前 Obsidian 的工作区状态(比如打开了哪些笔记、页面布局),会被频繁修改,上传到 GitHub 容易造成同步冲突。
-
打开本地仓库根目录,新建一个文件,命名为 .gitignore;
-
在 .gitignore 文件中添加两行内容,将冲突文件排除:
.obsidian/workspace.json
.obsidian/workspace-mobile.json

每次修改笔记后手动提交,时间久了会很麻烦,借助 Obsidian 的 Git 插件,就能实现自动同步,步骤如下:
- 打开 Obsidian,点击左下角齿轮(设置),选择“第三方插件”,关闭“安全模式”;

- 在社区插件市场搜索“Git”,安装并启用该插件;

- 点击插件“选项”,进行配置:

-
Auto commit and push after stopping file edits:停止编辑笔记1分钟后,自动同步到 GitHub(将分钟数改为1);
-
Pull on startup:启动 Obsidian 时,自动从 GitHub 拉取最新版本,保持本地与云端同步。
配置完成后,无论是在本地修改笔记,还是在 GitHub 网页端修改文件,都会自动同步,再也不用手动提交了。另外,除了 GitHub 同步,也可以将笔记文件夹定时备份到网盘或硬盘,实现冷备份,双重保障笔记不丢失。
Obsidian + AI:解锁高效创作新玩法
Obsidian 本身不提供 AI 功能,但我们可以通过两种方式接入 AI:一是使用社区 AI 插件,二是使用 AI 编程工具(比如 Cloud Code、Gemini CLI)。
claude code 相关内容可以参考之前的文章:Claude Code 完整学习手册:安装配置、CCR、MCP、插件与 Superpowers开发框架
obsidian claudian 插件
想在obsidian中使用claude code,需要安装插件。将项目中的claudian skills加入到插件文件夹中,然后把claudian插件打开即可:


点击左侧的小机器人头像,就可以打开claudian窗口:

注意 ------ 还需要给claudian进行环境配置:自定义环境中填入URL和api key,可以使用国产模型或者claude模型:

obsidian skills
把项目中的json-canvas,obsidian-bases,obsidian-markdown三个skills放到磁盘根目录的.claude的skills文件夹中,如果没有skills文件夹,需要自己创建。

放置完成后重启obsidian软件,然后询问:我都有哪些skills。

帮我把这个文档整理成Canvas结构图:效果如下

论文推荐解读 skills
同样的,把项目中的skills放到磁盘根目录的.claude的skills文件夹中。
在 claude code 或 obsidian 中执行skills
技能+研究方向
/start-my-day Multi-objective operational vehicle designFlexible job shop scheduling
系统会自动从 arXiv 和 Semantic Scholar 中爬取高质量的论文。系统每天推荐10篇论文,AI从四个维度对每篇论文打分,相关性,热度,发布时间,质量。最后按总分从高到低排序返回。
前三篇高分论文系统会自动在对应的目录下生成详细的笔记,包括标签和论文间的关系图谱。
如果想深入阅读论文 在claude code中输入 /paper-analyze +论文编号


图片管理优化
Obsidian 自带的图片存储功能不算好用:图片会和笔记放在同级目录,文件多了会很乱;而且图片链接不是标准 Markdown 格式,在 GitHub、VS Code 中无法正常显示。借助一款插件,就能完美解决这个问题。
插件:Custom Attachment Location(自定义附件存储)
安装与配置步骤:
- 打开 Obsidian 设置 → 第三方插件 → 搜索“Custom Attachment Location”,安装并启用;

- 点击插件“设置”,修改两项关键配置:
- Markdown URL 格式:填写标准 Markdown 图片路径(如下如所示);

- 附件重命名模式:选择“全部”,勾选“是否重命名附件文件”。

- 打开 Obsidian 系统设置 → 文件与链接,取消“基于仓库根目录的绝对路径”,内部链接类型选择“基于当前笔记的相对路径”。

优化效果:
-
图片会自动存入 assets 文件夹,每篇笔记对应一个同名子文件夹,整洁有序;
-
重命名笔记时,图片文件夹和图片链接会自动同步更新;
-
图片链接为标准 Markdown 格式,在 GitHub、VS Code 中都能正常显示;
笔记导出为 Word/HTML/PDF
Obsidian 本身不支持直接导出为 Word、HTML 等格式,但借助插件和工具,就能实现万能导出,步骤如下:
工具与插件:Enhancing Export + Pandoc
- 安装插件:打开 Obsidian 设置 → 第三方插件 → 搜索“Enhancing Export”,安装并启用;

- 安装 Pandoc:将项目中pandoc解压后将可执行程序放在电脑某个目录下;
打开 Enhancing Export 插件设置,粘贴 Pandoc 的文件路径;

导出笔记:右键选中需要导出的笔记,选择“Export”,可选择 Word、HTML、PDF 等格式,导出后配图和格式都会完美保留。

双向链接与知识图谱
Obsidian 最强大的功能之一,就是双向链接和知识图谱,能帮助我们高效归纳知识、发现灵感,搭建自己的“第二大脑”。
- 双向链接:在笔记中输入 [[笔记标题]],就能快速链接到另一篇笔记,按住 Ctrl 键点击链接,可打开新标签页查看;如果觉得链接太长,还可以修改显示名称;

- 知识图谱:点击左侧“查看关系图谱”,所有笔记会以节点形式平铺,有链接关系的笔记会用线条连接,随着笔记增多,图谱会越来越复杂,能清晰看到知识之间的关联,帮助我们梳理思路、迸发灵感。

更多推荐




所有评论(0)