Obsidian（Markdown笔记软件） 插件 + claude code 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 键点击链接，可打开新标签页查看；如果觉得链接太长，还可以修改显示名称；
- 知识图谱：点击左侧“查看关系图谱”，所有笔记会以节点形式平铺，有链接关系的笔记会用线条连接，随着笔记增多，图谱会越来越复杂，能清晰看到知识之间的关联，帮助我们梳理思路、迸发灵感。
