概要

Obsidian 最吸引人的一点,就是它的笔记存储方式——所有笔记本质上都是本地电脑上的独立 Markdown 文件。这意味着,哪怕 Obsidian 开发者跑路、软件停更,笔记也不会丢失,换任何一款 Markdown 编辑器(比如 VS Code、Typora)都能继续编辑使用。

为了进一步保障安全,可以搭配 GitHub 进行云端同步备份——GitHub 作为全球最大的源代码托管平台,早已成为计算机科学的基础设施,把笔记备份在上面,比存在任何云笔记、网盘都要安全稳定。

Obsidian 本身不带 AI 功能,但它的本地 Markdown 特性,让它和 AI 工具(比如 Cloud Code、Gemini CLI)成了绝配。AI 编程工具天生擅长处理本地文件,尤其是 Markdown 格式,两者结合,能玩出很多神奇的用法:

  • 让 AI 帮我检索笔记、整理文件夹,省去手动分类的麻烦;

  • 模仿自己的文风写笔记、写视频脚本,提高创作效率;

  • 根据过往的视频/笔记思路,结合热点,生成爆款选题;

  • 批量处理文件,比如批量创建选题文件夹、整理大纲。

obsidian下载地址

在这里插入图片描述
github 项目地址

下面所有用到的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 容易造成同步冲突

  1. 打开本地仓库根目录,新建一个文件,命名为 .gitignore;

  2. 在 .gitignore 文件中添加两行内容,将冲突文件排除:

.obsidian/workspace.json
.obsidian/workspace-mobile.json

在这里插入图片描述

每次修改笔记后手动提交,时间久了会很麻烦,借助 Obsidian 的 Git 插件,就能实现自动同步,步骤如下:

  1. 打开 Obsidian,点击左下角齿轮(设置),选择“第三方插件”,关闭“安全模式”;

在这里插入图片描述

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

在这里插入图片描述

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

在这里插入图片描述

  • 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插件打开即可:

github 项目地址

在这里插入图片描述

在这里插入图片描述

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

在这里插入图片描述

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

在这里插入图片描述

obsidian skills

github 项目地址

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

在这里插入图片描述

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

在这里插入图片描述

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

在这里插入图片描述

论文推荐解读 skills

github 项目地址

同样的,把项目中的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(自定义附件存储)

安装与配置步骤:

  1. 打开 Obsidian 设置 → 第三方插件 → 搜索“Custom Attachment Location”,安装并启用;

在这里插入图片描述

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

在这里插入图片描述

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

在这里插入图片描述

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

在这里插入图片描述

优化效果:

  • 图片会自动存入 assets 文件夹,每篇笔记对应一个同名子文件夹,整洁有序;

  • 重命名笔记时,图片文件夹和图片链接会自动同步更新;

  • 图片链接为标准 Markdown 格式,在 GitHub、VS Code 中都能正常显示;

笔记导出为 Word/HTML/PDF

Obsidian 本身不支持直接导出为 Word、HTML 等格式,但借助插件和工具,就能实现万能导出,步骤如下:

工具与插件:Enhancing Export + Pandoc

  1. 安装插件:打开 Obsidian 设置 → 第三方插件 → 搜索“Enhancing Export”,安装并启用;

在这里插入图片描述

  1. 安装 Pandoc:将项目中pandoc解压后将可执行程序放在电脑某个目录下;

打开 Enhancing Export 插件设置,粘贴 Pandoc 的文件路径;

在这里插入图片描述

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

在这里插入图片描述

双向链接与知识图谱

Obsidian 最强大的功能之一,就是双向链接和知识图谱,能帮助我们高效归纳知识、发现灵感,搭建自己的“第二大脑”。

  1. 双向链接:在笔记中输入 [[笔记标题]],就能快速链接到另一篇笔记,按住 Ctrl 键点击链接,可打开新标签页查看;如果觉得链接太长,还可以修改显示名称;

在这里插入图片描述

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

在这里插入图片描述

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐