Obsidian Canvas 基础
学习目标
- 了解 Canvas 的概念与适用场景。
- 掌握 Canvas 画布的创建与基本操作。
- 掌握卡片添加、连接线绘制、内容组织与分组。
- 掌握 Canvas 导出与嵌入笔记的方法。
- 了解社区插件 Advanced Canvas 的安装方式与常用增强能力。
前置条件
- 已安装 Obsidian 并打开本仓库为 Vault(参考 section1/01)。
- 确认核心插件 Canvas 已开启(设置 → 核心插件 → Canvas)。
- 如需体验增强功能,请确保已开启社区插件并允许安装第三方插件。
Canvas 是什么
Canvas(画布)是 Obsidian 内置的可视化编辑工具,让你可以在无限画布上自由放置卡片、连接线、图片和网页嵌入,用于:
- 思维导图:将想法可视化,建立关联。
- 课程地图:展示知识点的依赖关系。
- 项目规划:用卡片组织任务、资源和时间线。
- 白板协作:自由绘制草图、添加便签。
Canvas 文件以
.canvas格式保存(本质是 JSON),可以纳入 Git 版本控制,也可以被 WikiLink 引用。
步骤
第 1 步:创建 Canvas 画布
方法一:通过命令面板
- 在 Obsidian 中按
Ctrl+P打开命令面板。 - 输入 “Canvas”,选择 Canvas:新建画布。
- 输入画布名称(如 “课程地图”),按回车。
方法二:通过文件列表
- 在左侧文件列表中,导航到目标文件夹(如
section5/)。 - 右键点击文件夹空白处 → 新建画布。
- 输入名称。
方法三:通过快捷键(可自定义)
默认无快捷键,你可以在设置 → 快捷键中搜索 “Canvas: New canvas” 自行绑定。
第 2 步:了解 Canvas 界面
创建画布后,你会看到一个空白无限画布,主要界面元素:
| 元素 | 说明 |
|---|---|
| 画布背景 | 无限网格,支持缩放和平移 |
| 工具栏(顶部) | 添加卡片、连接线、便签、图片、网页等 |
| 卡片 | 可包含文本、Markdown 内容或嵌入笔记 |
| 连接线 | 箭头或直线,用于表示卡片间的关系 |
| 分组 | 将多个卡片组合为逻辑区域 |
快捷键:
| 操作 | Windows |
|---|---|
| 平移画布 | Ctrl + 鼠标拖拽 或 鼠标中键拖拽 |
| 缩放画布 | Ctrl + 滚轮 或 触控板双指缩放 |
| 适应画布 | Ctrl + 0 |
| 删除选中 | Delete 或 Backspace |
第 3 步:添加卡片
文本卡片:
- 双击画布空白处,创建一个文本卡片。
- 输入内容,支持 Markdown 语法(标题、列表、粗体等)。
- 拖拽卡片边缘调整大小。
笔记卡片(嵌入已有笔记):
- 从左侧文件列表拖拽一个
.md文件到画布上。 - 卡片显示笔记标题和预览内容。
- 双击卡片可在 Obsidian 中打开该笔记。
通过工具栏添加:
点击顶部工具栏的图标添加不同类型卡片:
| 工具栏按钮 | 快捷键 | 说明 |
|---|---|---|
| 卡片 | N | 创建空文本卡片 |
| 便签 | — | 创建黄色便签卡片 |
| 媒体 | — | 嵌入图片、视频、音频 |
| 网页 | — | 嵌入网页(输入 URL) |
卡片内容编辑
文本卡片支持完整的 Markdown 语法,包括
**粗体**、- 列表、> 引用、`代码`等。双击卡片进入编辑模式。
第 4 步:连接卡片
添加连接线:
- 鼠标悬停在一个卡片上,卡片边缘会出现小圆点(连接点)。
- 从连接点拖拽到另一个卡片,即可创建连接线。
- 连接线默认带箭头,指向目标卡片。
修改连接线:
- 点击连接线选中它,可以拖拽调整路径。
- 右键连接线 → 删除 移除它。
- 选中连接线后,在右侧属性面板可调整:
- 颜色:使用不同颜色标识不同类型的关系。
- 线宽:加粗或变细。
- 箭头:无箭头 / 单向箭头 / 双向箭头。
- 线型:直线 / 曲线。
颜色编码建议
- 🔵 蓝色 — 前置依赖
- 🟢 绿色 — 同层级关联
- 🟠 橙色 — 扩展阅读
- 🔴 红色 — 需要注意/冲突
第 5 步:组织卡片
移动卡片:
直接拖拽卡片即可移动。移动时按住 Shift 保持水平或垂直对齐。
多选卡片:
- 按住
Ctrl点击多个卡片。 - 或拖拽选框选中多个卡片。
分组卡片:
- 选中多个卡片。
- 右键 → 创建组。
- 输入组名称(可选),选择组颜色。
- 分组会以半透明背景框围绕卡片。
对齐与排列:
选中多个卡片后,右键菜单提供对齐工具:
- 左对齐 / 居中对齐 / 右对齐
- 顶部对齐 / 垂直居中 / 底部对齐
- 水平均匀分布 / 垂直均匀分布
第 6 步:使用标签与嵌入
标签(Label):
文本卡片中可用 #标签 添加标签,标签会在画布中高亮显示,并可在 Obsidian 中被搜索到。
嵌入笔记 / 图片 / 网页:
- 从文件管理器拖拽文件到画布。
- 使用工具栏的”嵌入”按钮,选择文件或输入 URL。
- 嵌入的网页会在卡片中实时渲染。
第 7 步:导出与分享
Canvas 目前支持以下导出方式:
复制为截图:
- 右键画布空白处 → 复制截图。
- 粘贴到其他应用(Word、PPT、聊天窗口)。
作为附件嵌入笔记:
你可以在笔记中使用 ![[画布名称.canvas]] 嵌入整个画布,预览视图会显示为截图。
纳入 Git 版本控制:
.canvas 文件本质上是 JSON 文本,可以直接提交到 Git 仓库,方便团队共享和追踪变更。
第 8 步:安装 Advanced Canvas 插件
Advanced Canvas 是社区中最常用的 Canvas 增强插件之一,可在保留原生体验的同时增加大量高级能力。
安装步骤:
- 进入 Obsidian 设置 → 社区插件。
- 关闭安全模式(若尚未关闭)。
- 点击 浏览,搜索
Advanced Canvas。 - 选择插件并点击 安装,安装后点击 启用。
官方页面:
建议做法
Advanced Canvas 的功能开关很多。建议先按默认配置使用,熟悉后再逐项开启高级选项,避免一次改动过多导致不适应。
第 9 步:体验常用增强功能
安装完成后,你可以优先体验以下高频功能:
| 功能 | 作用 | 快速体验方式 |
|---|---|---|
| 原生风格画布搜索 | 在当前 Canvas 内快速检索文本 | 打开 Canvas 后按 Ctrl+F |
| 可折叠分组 | 大画布中按层级收起/展开内容 | 选中分组后使用折叠操作 |
| Portal(门户) | 在当前画布中嵌入另一个 Canvas | 先嵌入 Canvas 文件,再切换为 Portal |
| 演示模式 | 把节点连线转换为“幻灯片路径” | 命令面板执行 Advanced Canvas: Start presentation |
| 增强导出 | 导出 PNG/SVG,支持透明背景等选项 | 右键画布或命令面板执行导出 |
| 节点模板 | 复用常用卡片样式,统一视觉 | 选中单节点后保存为模板 |
| 增强 frontmatter | 为 .canvas 文件添加可搜索元数据 | 右上角信息按钮打开并编辑 frontmatter |
第 10 步:使用增强 frontmatter(重点)
Advanced Canvas 支持直接在 Canvas 视图中为 .canvas 文件编辑 frontmatter,这样可以让画布像普通笔记一样参与组织与检索。
常见用途:
- 为课程地图增加
tags,便于全局搜索和筛选。 - 设置
aliases,让画布可通过别名被快速链接。 - 设置
cssclasses,给整张画布应用统一样式。 - 添加自定义字段(如
status、owner、review_cycle)用于协作管理。
示例:
---
tags:
- tutorial
- canvas-map
aliases:
- 课程总览图
cssclasses:
- canvas-course-map
status: active
owner: tutorial-team
review_cycle: weekly
---实践建议
frontmatter 字段名建议在团队内统一命名(例如统一使用
status,不要混用state),后续做批量筛选会更稳定。
第 11 步:兼容性与协作建议
- 插件生成的高级样式在未安装插件的环境中可能表现为“降级显示”。
- 团队协作时,建议在仓库文档中注明“此 Canvas 使用了 Advanced Canvas 功能”。
- 若需最大兼容性(例如仅用于 GitHub 查看 JSON),优先保留基础结构,再逐步添加增强样式。
扩展阅读
常见问题
Q:Canvas 文件存在哪里?
A:.canvas 文件保存在你创建时所在的文件夹,与其他 markdown 文件一样,受 Git 管理。
Q:为什么我的工具栏没有某些按钮?
A:请确认 Canvas 核心插件已开启。如仍未显示,检查是否有其他插件冲突。
Q:卡片中的 Markdown 预览不完全?
A:Canvas 中的卡片渲染与笔记预览略有不同,部分复杂 Markdown 可能显示为纯文本。建议在笔记中编辑,然后嵌入到 Canvas 中。
Q:不小心删除了卡片,可以撤销吗?
A:可以。按 Ctrl+Z 撤销删除,Canvas 支持多步撤销。
Q:如何将外部图片添加到 Canvas?
A:直接拖拽图片文件到画布上,或使用工具栏的”媒体”按钮选择文件。
练习任务
- 在
section5/文件夹中创建一个新的 Canvas 画布。 - 添加至少 5 个文本卡片,使用 Markdown 格式输入内容。
- 用连接线将卡片连接起来,并修改颜色和线型。
- 创建一个卡片组,为组命名。
- 尝试对齐多张卡片。
- 嵌入一个网页卡片(如输入
https://obsidian.md)。 - (可选)安装
Advanced Canvas,至少体验 2 个增强功能(如Ctrl+F搜索 + 演示模式)。 - (可选)为你的
.canvas文件添加 frontmatter(至少包含tags与一个自定义字段)。
验收清单
- 能创建新的 Canvas 画布
- 能添加文本卡片、笔记卡片、网页嵌入
- 能用连接线连接卡片,并调整颜色和样式
- 能创建卡片组并对齐排列
- 能在笔记中嵌入 Canvas(
![[name.canvas]]) - 了解 Canvas 的适用场景
- (可选)已安装 Advanced Canvas 并实际使用至少 2 个增强功能
- (可选)已为
.canvas文件添加并使用 frontmatter 元数据