从 VS Code 迁移到 Obsidian
VS Code 是强大的编辑器，但其笔记工作流与 Obsidian 有本质差异。本文帮你平滑过渡。
为什么从 VS Code 迁移
| VS Code | Obsidian |
|---|---|
| 通用代码编辑器 | 专注笔记的知识管理工具 |
| 插件拼凑笔记功能 | 原生双向链接 + 图谱 |
| 手动管理文件关联 | 自动追踪反向链接 |
| 终端/Git 操作 | 图形化操作界面 |
| 适合技术人员 | 无需编程背景 |
快速对比
VS Code 笔记扩展 vs Obsidian
| VS Code 方案 | Obsidian 对应功能 |
|---|---|
| Foam (双向链接) | 原生 [[wiki-link]] |
| Dendron (层级笔记) | 文件夹 + 标签组织 |
| Markdown All in One | 内置 Markdown 编辑 |
| Markdown Preview Enhanced | 阅读视图 + 实时预览 |
| GitLens | Obsidian Git 插件 |
| Todo Tree | Tasks 插件 |
| Markdown Notes (标签) | 原生标签 + Dataview |
数据迁移
Markdown 文件直接可用
好消息：.md 文件可以直接放入 Obsidian 仓库：
bash
# 1. 创建 Obsidian 仓库
# 2. 复制所有 .md 文件
cp -r ~/my-notes/*.md ~/Obsidian/MyVault/Wiki 链接转换
如果你的 VS Code 使用 [[wiki-link]] 格式（如 Foam）：
yaml
状态: 无需转换
说明: Obsidian 原生支持 [[链接]] 语法
操作: 直接使用如果使用 [text](./file.md) 格式：
yaml
状态: 直接兼容
说明: Obsidian 同时支持两种链接格式
操作: 无需转换元数据迁移
YAML Front Matter 完全兼容：
yaml
---
title: 我的笔记
tags: [技术, 前端]
created: 2024-01-15
---只需注意：Obsidian 新版本使用 tags: 而非 tag:。
功能迁移对照
搜索 → Obsidian 搜索
VS Code: Ctrl+Shift+F → 全局搜索
Obsidian: Ctrl+Shift+F → 全局搜索 + 高级语法
# Obsidian 增强：
path:docs/ line:代码 # 按路径和关键词
file:".md" tag:技术 # 按文件类型和标签
正则: /TODO.*#(\w+)/ # 支持正则表达式Git 版本控制 → Obsidian Git 插件
bash
# VS Code: 终端操作
git add . && git commit -m "update"
# Obsidian: 安装 Obsidian Git 插件后
# 自动定时提交 + 侧边栏面板查看历史安装配置详见 Obsidian Git。
大纲/文件导航 → Obsidian 核心功能
VS Code Explorer → Obsidian 左侧文件列表
VS Code Outline → Obsidian 大纲面板
VS Code Breadcrumbs → Obsidian 笔记属性面板
VS Code Ctrl+P (文件跳转) → Obsidian Ctrl+O (快速切换)工作流重建
Foam 用户
Foam 的核心概念可平滑迁移：
| Foam 功能 | Obsidian 等效 | 配置 |
|---|---|---|
| 每日笔记 | 日记核心插件 | 设置 → 核心插件 → 日记 |
| 图谱 | 图谱核心插件 | 已内置，效果更好 |
| 反链面板 | 反向链接核心插件 | 已内置 |
| 模板 | Templater 社区插件 | 功能远超 Foam 模板 |
| 标签浏览 | 标签面板核心插件 | 已内置 |
| 未尽链接 | 出链面板 | 核心插件 |
Dendron 用户
Dendron 的层级结构对应 Obsidian：
Dendron: tech.js.react → tech/js/react.md
Obsidian: tech/js/react.md + 标签或属性层级yaml
# Dendron 层级 → Obsidian 属性
---
category: ["tech", "js", "react"]
---
# 配合 Dataview 实现层级浏览：
# FROM #tech SORT file.path ASC纯 Markdown 笔记用户
| 习惯 | 适应方式 |
|---|---|
| 侧边栏预览 | 打开阅读视图 Ctrl+E |
| 多标签页 | Obsidian 原生支持标签页 |
| 自定义快捷键 | 设置 → 快捷键，可完全自定义 |
| 代码高亮 | 原生支持 200+ 语言 |
| 终端操作 | Shell Commands 插件 + URI 协议 |
推荐插件组合
从 VS Code 迁移，推荐以下插件组合：
| VS Code 习惯 | 推荐插件 |
|---|---|
| 代码编辑快捷键 | Editing Toolbar |
| Git 操作 | Obsidian Git |
| 文件大纲 | 原生大纲面板（核心插件） |
| Prettier 格式化 | Linter 插件 |
| 代码片段 | Templater |
| Todo Tree | Tasks 插件 |
| 终端面板 | Shell Commands + Terminal 插件 |
过渡策略
渐进式迁移（推荐）
第 1 周：安装 Obsidian，打开你的 .md 文件夹作为仓库
→ 保持 VS Code 中的工作习惯
→ 逐步在 Obsidian 中阅读和编辑
第 2 周：在 Obsidian 中创建新笔记
→ 学习 [[双链]] 语法
→ 安装 2-3 个核心插件
第 3 周：配置模板和快捷键
→ 建立每日笔记习惯
→ 逐步关闭 VS Code 笔记工作区
第 4 周：完全切换到 Obsidian
→ VS Code 做为代码编辑器保留
→ Obsidian 全面接管笔记管理共存模式
两者可以长期共存：
bash
# Obsidian 仓库同时也是 VS Code 工作区
~/notes/ # Obsidian 仓库根目录
├── .obsidian/ # Obsidian 配置
├── .vscode/ # VS Code 工作区配置
├── daily/ # 日记
└── projects/ # 项目笔记在 VS Code 中打开同一文件夹，两边的修改实时同步。
常见疑问
Q: VS Code 里装的 Markdown 插件怎么办？
A: Obsidian 内置了大部分功能。需要额外特性的安装社区插件即可。
Q: 能用 VS Code 编辑器打开 Obsidian 笔记吗？
A: 可以。右键文件 → 在系统浏览器中显示 → 用 VS Code 打开。可结合 Shell Commands 一键切换。
Q: 双向链接在 VS Code 里能看到吗？
A: 不能直接预览，但 [[link]] 格式是纯文本，可以在 VS Code 中看到引用关系。
Q: 我最爱的 VS Code 主题能移植吗？
A: Obsidian 有 500+ 主题。如果没有对应版本，可用本文介绍的 CSS 变量快速自定义：CSS 代码片段。
相关资源
- Markdown 语法 — Obsidian Markdown 完整语法
- Obsidian Git — Git 版本控制插件
- 快捷键速查 — 快捷键对照
- 主题定制入门 — 零基础外观自定义