面向:在 Obsidian 里跟 Blender 教程视频做笔记(时间戳 + 截图)。
- 官方仓库:aidenlx/media-extended
- 社区页:Media Extended
- 本教程版本:4.2.7(manifest 要求 Obsidian ≥ 1.12.0)
- 仅桌面端(
isDesktopOnly: true),手机 App 不可用
许可说明: v4 起逐步闭源;v3 及以前仍为 MIT 开源。4.2.7 属于 v4 线。
0. 安装前检查
- 已安装 Obsidian 桌面版,版本 ≥ 1.12.0(设置 → 关于 → 看当前版本)
- 准备好一个库(Vault),例如专门学 Blender 的库
- 能访问社区插件(关闭「受限模式」)
1. 安装方法(任选其一)
方法 A:社区插件商店(最推荐)
4.2.7 已在社区插件列表中,多数人用这个即可。
- 打开你的 Vault
- 左下角 设置(齿轮)
- 社区插件 → 关闭 受限模式(Restricted Mode)
- 点 浏览(Browse)
- 搜索
Media Extended - 确认作者为 AidenLx,点 安装
- 安装完成后回到「已安装插件」列表,打开 Media Extended 开关
核对版本是否为 4.2.7:
- 设置 → 社区插件 → 已安装 → Media Extended
- 或看插件详情里的 Version:应为
4.2.7 - 若显示更旧:点插件旁的 检查更新 / Update
方法 B:BRAT(适合固定/跟踪 GitHub 发行版)
若商店里版本不对,或你想直接装 GitHub 上的 4.2.7:
- 先用商店安装 BRAT(搜索
Obsidian42 - BRAT)并启用 Ctrl+P(Mac:Cmd+P)打开命令面板- 运行:
BRAT: Add a beta plugin for testing - 仓库填:
aidenlx/media-extended
- 装完后在社区插件列表中 启用 Media Extended
- 确认版本为 4.2.7
也可在浏览器打开(需已装 BRAT):
obsidian://brat?plugin=aidenlx/media-extended
方法 C:手动安装指定 4.2.7(最稳地锁版本)
当商店自动升到更新版、你又想钉死 4.2.7 时用。
- 打开发行页:
https://github.com/aidenlx/media-extended/releases/tag/4.2.7 - 下载
media-extended.zip(或分别下载main.js、manifest.json、styles.css) - 在 Obsidian:设置 → 社区插件 → 打开 插件文件夹
路径形如:你的库/.obsidian/plugins/ - 新建文件夹,名称必须是:
media-extended
- 把 zip 解压内容放进该文件夹,最终应类似:
.obsidian/plugins/media-extended/
├── main.js
├── manifest.json
└── styles.css
- 重启 Obsidian,或在社区插件页刷新后 启用 Media Extended
- 打开
manifest.json确认:"version": "4.2.7"
2. 第一次启用后建议设置
设置 → Media Extended(左侧插件设置区):
| 建议 | 说明 |
|---|---|
| 看一眼时间戳模板 | 控制插入笔记的链接长什么样 |
| 截图保存位置 | 默认常进附件目录;学 Blender 建议配合「按笔记分子文件夹」类附件插件 |
| 快捷键 | 去 设置 → 快捷键,搜索 Media Extended,给常用命令绑键 |
推荐快捷键(可自定)
在 设置 → 快捷键 里搜索并绑定,例如:
| 命令(大致名称) | 建议按键 | 用途 |
|---|---|---|
| Open media | Ctrl+Shift+O | 打开媒体快速切换 |
| 插入时间戳 / Timestamp | Ctrl+Shift+T | 当前进度写进笔记 |
| 截图 / Screenshot | Ctrl+Shift+S | 当前帧截图进笔记 |
| Play / Pause | Ctrl+Shift+Space | 不切回播放器也能暂停 |
3. 基本使用:打开媒体
3.1 库内本地视频(最简单)
- 把教程 mp4/mkv/webm 等放进库,例如:
02 Videos/media/教程名.mp4 - 在文件列表里 单击该文件 → 用 Media Extended 播放器打开
3.2 媒体快速切换(Open media)
- 点左侧功能区的 播放图标,或
Ctrl+P→ 输入Media Extended: Open media- 在输入框里可以:
- 粘贴 YouTube / Bilibili / Vimeo 等链接
- 输入库内相对路径
- 输入库外绝对路径
- 拖拽 一个视频文件进去
- 回车打开
3.3 从浏览器一键丢进 Obsidian
浏览器地址栏把链接改成(或书签脚本生成)例如:
obsidian://mx-open?url=https://www.youtube.com/watch?v=UF8uR6Z6KLc
规则:在原视频 URL 前加上协议,并用参数形式。官方 Quick Start 示例:
obsidian://mx-open?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DUF8uR6Z6KLc
装好插件后,把上面整行粘到浏览器地址栏回车,应唤起 Obsidian 并打开该视频。带起始时间示例:
obsidian://mx-open?url=https://www.youtube.com/watch?v=xxxx&t=120
3.4 支持的常见来源
| 类型 | 示例 |
|---|---|
| 本地音视频 | mp4、mkv、webm、mp3、wav 等 |
| YouTube | 完整 URL 或视频 ID |
| Vimeo | URL |
| bilibili | URL |
| 其它直接媒体链接 | 浏览器能播的直链 |
在线视频需要本机网络;部分站点可能要登录(命令面板里通常有 Login website 一类命令)。
4. 核心功能一:时间戳笔记
这是跟课最重要的功能。
操作步骤
- 打开视频,左侧或旁边再开一篇笔记(分栏:左视频右笔记)
- 播到要记的地方,暂停
- 点播放器上的 时间戳按钮(⭐ / Timestamp),或用你绑定的快捷键
- 笔记里会出现可点击的时间链接(格式由模板决定)
- 在链接下方写说明,例如:
挤出面 + Ctrl+R 环切
点击时间戳会发生什么
在 阅读视图 下点击时间戳,播放器会跳到对应秒数。若点了没反应:先切到阅读模式,或确认播放器仍是「活动」状态。
固定播放器(强烈建议)
避免每点一个链接就新开一堆标签:
- 在播放器标签上 右键
- 选 固定(Pin)
- 之后在不同笔记间切换,仍共用这一个播放器
活动播放器标签上常有红色指示,表示当前笔记命令会控制哪一个播放器。
5. 核心功能二:截图回链
适合记 Blender 界面、节点树、参数面板。
操作步骤
- 播到关键画面,暂停
- 点播放器上的 截图按钮(📷),或快捷键
- 按提示裁剪(若开启)
- 图片会保存到库内,并插入当前笔记,通常带「回到该时刻」的链接
之后复习:点图旁时间链接 → 回到原视频位置。
截图文件会占空间;大课建议附件按笔记分文件夹存放。
6. 字幕 / 文稿(Transcript)
若有 .srt / .vtt:
- 将字幕文件与视频关联(插件设置或对应命令,以 4.2.7 界面为准)
- 可在文稿里搜索关键词
- 点击某句字幕可跳转到对应时间
- 可复制「带时间戳的引文」进笔记
适合长教程:先搜「Boolean」「Geometry Nodes」,再精看片段。
7. 链接与嵌入语法(进阶)
Media Extended 支持带时间片段的链接/嵌入,常见能力包括:
| 能力 | 含义 |
|---|---|
#t=... | 从某时刻开始 |
| 起止时间 | 只播某一段 |
| loop | 循环该段 |
| autoplay | 打开时自动播 |
具体写法以插件文档/设置为准;日常跟课用「时间戳按钮」即可,不必手写。
8. 学 Blender 的推荐工作流(照着做)
第 1 次完整练习(约 15 分钟)
- 新建笔记:
02 Videos/notes/硬表面入门-01.md - 把教程 mp4 放进
02 Videos/media/,或准备好 YouTube 链接 Open media打开视频 → Pin 固定播放器- 分栏:左播放器,右笔记
- 每学一个操作:暂停 → ⭐ 时间戳 → 写 1 句步骤
- 界面难看清时:📷 截一张
- 复习时只点时间戳,不必重刷整集
笔记结构示例
# 硬表面入门 01
来源:[[教程视频文件]] 或 YouTube 链接
Blender 版本:4.x
## 步骤
- [时间戳链接 00:12] 新建立方体,进入编辑模式
- [时间戳链接 03:45] Ctrl+R 环切,滚轮加段数
-  ← 带回到 05:20 的链接
## 复盘
今天卡在:法线方向 / 布尔失败原因 …
和 Obsidian 其它插件配合
| 需求 | 配合 |
|---|---|
| 收藏文章 | Obsidian Web Clipper |
| 预览自己的模型 | 导出 .glb + Model Viewer |
| 附件不乱 | Custom Attachment Location |
| 记住快捷键 | Spaced Repetition |
9. 常见问题排查
| 现象 | 处理 |
|---|---|
| 插件列表没有 Media Extended | 关闭受限模式;检查网络;或改用手动/BRAT |
| 安装后无法启用 | Obsidian 是否 ≥ 1.12.0;是否桌面版 |
| 手机打不开 | 正常:4.2.7 为桌面专用 |
| YouTube 黑屏 / 要登录 | 命令面板找登录相关命令;换网络或先下载本地再用 |
| 点时间戳不跳转 | 切到阅读视图;确认播放器已 Pin 且为活动播放器 |
| 截图找不到 | 到设置看截图保存路径;在库内搜索当天图片 |
| 库外视频播不了 | 插件需要访问库外文件权限;确认路径仍存在(移动硬盘盘符变了会失效) |
| 想锁在 4.2.7 不被升级 | 用方法 C 手动安装,并在 Obsidian 里谨慎点「更新」 |
10. 安全与隐私提示(官方披露摘要)
- 可能访问库外文件:播放外置硬盘 / OneDrive 等路径上的媒体时需要
- 需要联网:播 YouTube、Vimeo、Bilibili 或你配置的远程存储时
- 仅在你主动打开的链接/配置的服务时联网
来源:社区插件页说明
11. 一分钟检查清单(装完自测)
- ☐ 社区插件里 Media Extended 已开启,版本 4.2.7
- ☐
Open media能打开本地 mp4 或一条 YouTube - ☐ 播放器已 Pin
- ☐ ⭐ 能在笔记里插入时间戳,点击可跳转
- ☐ 📷 能插入截图
- ☐ 已给「打开媒体 / 时间戳 / 截图 / 播放暂停」绑好快捷键
全部打勾,就可以正式用来跟 Blender 教程了。
12. 参考链接
- 发行版 4.2.7:https://github.com/aidenlx/media-extended/releases/tag/4.2.7
- GitHub:https://github.com/aidenlx/media-extended
- 社区插件:https://community.obsidian.md/plugins/media-extended
- 官方社区入口:https://mx.aidenlx.site/community
教程依据官方 README、社区插件页、4.2.7 manifest 与公开使用文档整理。界面文案以你安装的 4.2.7 中英文界面为准。