Obsidian Canvas 基础

学习目标

  • 了解 Canvas 的概念与适用场景。
  • 掌握 Canvas 画布的创建与基本操作。
  • 掌握卡片添加、连接线绘制、内容组织与分组。
  • 掌握 Canvas 导出与嵌入笔记的方法。
  • 了解社区插件 Advanced Canvas 的安装方式与常用增强能力。

前置条件

  • 已安装 Obsidian 并打开本仓库为 Vault(参考 section1/01)。
  • 确认核心插件 Canvas 已开启(设置 → 核心插件 → Canvas)。
  • 如需体验增强功能,请确保已开启社区插件并允许安装第三方插件。

Canvas 是什么

Canvas(画布)是 Obsidian 内置的可视化编辑工具,让你可以在无限画布上自由放置卡片、连接线、图片和网页嵌入,用于:

  • 思维导图:将想法可视化,建立关联。
  • 课程地图:展示知识点的依赖关系。
  • 项目规划:用卡片组织任务、资源和时间线。
  • 白板协作:自由绘制草图、添加便签。

Canvas 文件以 .canvas 格式保存(本质是 JSON),可以纳入 Git 版本控制,也可以被 WikiLink 引用。

步骤

第 1 步:创建 Canvas 画布

方法一:通过命令面板

  1. 在 Obsidian 中按 Ctrl+P 打开命令面板。
  2. 输入 “Canvas”,选择 Canvas:新建画布
  3. 输入画布名称(如 “课程地图”),按回车。

方法二:通过文件列表

  1. 在左侧文件列表中,导航到目标文件夹(如 section5/)。
  2. 右键点击文件夹空白处 → 新建画布
  3. 输入名称。

方法三:通过快捷键(可自定义)

默认无快捷键,你可以在设置 → 快捷键中搜索 “Canvas: New canvas” 自行绑定。

第 2 步:了解 Canvas 界面

创建画布后,你会看到一个空白无限画布,主要界面元素:

元素说明
画布背景无限网格,支持缩放和平移
工具栏(顶部)添加卡片、连接线、便签、图片、网页等
卡片可包含文本、Markdown 内容或嵌入笔记
连接线箭头或直线,用于表示卡片间的关系
分组将多个卡片组合为逻辑区域

快捷键:

操作Windows
平移画布Ctrl + 鼠标拖拽 或 鼠标中键拖拽
缩放画布Ctrl + 滚轮 或 触控板双指缩放
适应画布Ctrl + 0
删除选中DeleteBackspace

第 3 步:添加卡片

文本卡片:

  1. 双击画布空白处,创建一个文本卡片。
  2. 输入内容,支持 Markdown 语法(标题、列表、粗体等)。
  3. 拖拽卡片边缘调整大小。

笔记卡片(嵌入已有笔记):

  1. 从左侧文件列表拖拽一个 .md 文件到画布上。
  2. 卡片显示笔记标题和预览内容。
  3. 双击卡片可在 Obsidian 中打开该笔记。

通过工具栏添加:

点击顶部工具栏的图标添加不同类型卡片:

工具栏按钮快捷键说明
卡片N创建空文本卡片
便签创建黄色便签卡片
媒体嵌入图片、视频、音频
网页嵌入网页(输入 URL)

卡片内容编辑

文本卡片支持完整的 Markdown 语法,包括 **粗体**- 列表> 引用`代码` 等。双击卡片进入编辑模式。

第 4 步:连接卡片

添加连接线:

  1. 鼠标悬停在一个卡片上,卡片边缘会出现小圆点(连接点)。
  2. 从连接点拖拽到另一个卡片,即可创建连接线。
  3. 连接线默认带箭头,指向目标卡片。

修改连接线:

  • 点击连接线选中它,可以拖拽调整路径。
  • 右键连接线 → 删除 移除它。
  • 选中连接线后,在右侧属性面板可调整:
    • 颜色:使用不同颜色标识不同类型的关系。
    • 线宽:加粗或变细。
    • 箭头:无箭头 / 单向箭头 / 双向箭头。
    • 线型:直线 / 曲线。

颜色编码建议

  • 🔵 蓝色 — 前置依赖
  • 🟢 绿色 — 同层级关联
  • 🟠 橙色 — 扩展阅读
  • 🔴 红色 — 需要注意/冲突

第 5 步:组织卡片

移动卡片:

直接拖拽卡片即可移动。移动时按住 Shift 保持水平或垂直对齐。

多选卡片:

  • 按住 Ctrl 点击多个卡片。
  • 或拖拽选框选中多个卡片。

分组卡片:

  1. 选中多个卡片。
  2. 右键 → 创建组
  3. 输入组名称(可选),选择组颜色。
  4. 分组会以半透明背景框围绕卡片。

对齐与排列:

选中多个卡片后,右键菜单提供对齐工具:

  • 左对齐 / 居中对齐 / 右对齐
  • 顶部对齐 / 垂直居中 / 底部对齐
  • 水平均匀分布 / 垂直均匀分布

第 6 步:使用标签与嵌入

标签(Label):

文本卡片中可用 #标签 添加标签,标签会在画布中高亮显示,并可在 Obsidian 中被搜索到。

嵌入笔记 / 图片 / 网页:

  • 从文件管理器拖拽文件到画布。
  • 使用工具栏的”嵌入”按钮,选择文件或输入 URL。
  • 嵌入的网页会在卡片中实时渲染。

第 7 步:导出与分享

Canvas 目前支持以下导出方式:

复制为截图:

  1. 右键画布空白处 → 复制截图
  2. 粘贴到其他应用(Word、PPT、聊天窗口)。

作为附件嵌入笔记:

你可以在笔记中使用 ![[画布名称.canvas]] 嵌入整个画布,预览视图会显示为截图。

纳入 Git 版本控制:

.canvas 文件本质上是 JSON 文本,可以直接提交到 Git 仓库,方便团队共享和追踪变更。

第 8 步:安装 Advanced Canvas 插件

Advanced Canvas 是社区中最常用的 Canvas 增强插件之一,可在保留原生体验的同时增加大量高级能力。

安装步骤:

  1. 进入 Obsidian 设置 → 社区插件
  2. 关闭安全模式(若尚未关闭)。
  3. 点击 浏览,搜索 Advanced Canvas
  4. 选择插件并点击 安装,安装后点击 启用

官方页面:

建议做法

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,给整张画布应用统一样式。
  • 添加自定义字段(如 statusownerreview_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:直接拖拽图片文件到画布上,或使用工具栏的”媒体”按钮选择文件。

练习任务

  1. section5/ 文件夹中创建一个新的 Canvas 画布。
  2. 添加至少 5 个文本卡片,使用 Markdown 格式输入内容。
  3. 用连接线将卡片连接起来,并修改颜色和线型。
  4. 创建一个卡片组,为组命名。
  5. 尝试对齐多张卡片。
  6. 嵌入一个网页卡片(如输入 https://obsidian.md)。
  7. (可选)安装 Advanced Canvas,至少体验 2 个增强功能(如 Ctrl+F 搜索 + 演示模式)。
  8. (可选)为你的 .canvas 文件添加 frontmatter(至少包含 tags 与一个自定义字段)。

验收清单

  • 能创建新的 Canvas 画布
  • 能添加文本卡片、笔记卡片、网页嵌入
  • 能用连接线连接卡片,并调整颜色和样式
  • 能创建卡片组并对齐排列
  • 能在笔记中嵌入 Canvas(![[name.canvas]]
  • 了解 Canvas 的适用场景
  • (可选)已安装 Advanced Canvas 并实际使用至少 2 个增强功能
  • (可选)已为 .canvas 文件添加并使用 frontmatter 元数据