面向:在 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. 安装前检查

  1. 已安装 Obsidian 桌面版,版本 ≥ 1.12.0(设置 → 关于 → 看当前版本)
  2. 准备好一个库(Vault),例如专门学 Blender 的库
  3. 能访问社区插件(关闭「受限模式」)

1. 安装方法(任选其一)

方法 A:社区插件商店(最推荐)

4.2.7 已在社区插件列表中,多数人用这个即可。

  1. 打开你的 Vault
  2. 左下角 设置(齿轮)
  3. 社区插件 → 关闭 受限模式(Restricted Mode)
  4. 点 浏览(Browse)
  5. 搜索 Media Extended
  6. 确认作者为 AidenLx,点 安装
  7. 安装完成后回到「已安装插件」列表,打开 Media Extended 开关

核对版本是否为 4.2.7:

  • 设置 → 社区插件 → 已安装 → Media Extended
  • 或看插件详情里的 Version:应为 4.2.7
  • 若显示更旧:点插件旁的 检查更新 / Update

方法 B:BRAT(适合固定/跟踪 GitHub 发行版)

若商店里版本不对,或你想直接装 GitHub 上的 4.2.7:

  1. 先用商店安装 BRAT(搜索 Obsidian42 - BRAT)并启用
  2. Ctrl+P(Mac:Cmd+P)打开命令面板
  3. 运行:BRAT: Add a beta plugin for testing
  4. 仓库填:
aidenlx/media-extended
  1. 装完后在社区插件列表中 启用 Media Extended
  2. 确认版本为 4.2.7

也可在浏览器打开(需已装 BRAT):

obsidian://brat?plugin=aidenlx/media-extended

方法 C:手动安装指定 4.2.7(最稳地锁版本)

当商店自动升到更新版、你又想钉死 4.2.7 时用。

  1. 打开发行页:
    https://github.com/aidenlx/media-extended/releases/tag/4.2.7
  2. 下载 media-extended.zip(或分别下载 main.js、manifest.json、styles.css)
  3. 在 Obsidian:设置 → 社区插件 → 打开 插件文件夹
    路径形如:你的库/.obsidian/plugins/
  4. 新建文件夹,名称必须是:
media-extended
  1. 把 zip 解压内容放进该文件夹,最终应类似:
.obsidian/plugins/media-extended/
├── main.js
├── manifest.json
└── styles.css
  1. 重启 Obsidian,或在社区插件页刷新后 启用 Media Extended
  2. 打开 manifest.json 确认:"version": "4.2.7"

2. 第一次启用后建议设置

设置 → Media Extended(左侧插件设置区):

建议说明
看一眼时间戳模板控制插入笔记的链接长什么样
截图保存位置默认常进附件目录;学 Blender 建议配合「按笔记分子文件夹」类附件插件
快捷键去 设置 → 快捷键,搜索 Media Extended,给常用命令绑键

推荐快捷键(可自定)

在 设置 → 快捷键 里搜索并绑定,例如:

命令(大致名称)建议按键用途
Open mediaCtrl+Shift+O打开媒体快速切换
插入时间戳 / TimestampCtrl+Shift+T当前进度写进笔记
截图 / ScreenshotCtrl+Shift+S当前帧截图进笔记
Play / PauseCtrl+Shift+Space不切回播放器也能暂停

3. 基本使用:打开媒体

3.1 库内本地视频(最简单)

  1. 把教程 mp4/mkv/webm 等放进库,例如:02 Videos/media/教程名.mp4
  2. 在文件列表里 单击该文件 → 用 Media Extended 播放器打开

3.2 媒体快速切换(Open media)

  1. 点左侧功能区的 播放图标,或
  2. Ctrl+P → 输入 Media Extended: Open media
  3. 在输入框里可以:
    • 粘贴 YouTube / Bilibili / Vimeo 等链接
    • 输入库内相对路径
    • 输入库外绝对路径
    • 拖拽 一个视频文件进去
  4. 回车打开

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
VimeoURL
bilibiliURL
其它直接媒体链接浏览器能播的直链

在线视频需要本机网络;部分站点可能要登录(命令面板里通常有 Login website 一类命令)。


4. 核心功能一:时间戳笔记

这是跟课最重要的功能。

操作步骤

  1. 打开视频,左侧或旁边再开一篇笔记(分栏:左视频右笔记)
  2. 播到要记的地方,暂停
  3. 点播放器上的 时间戳按钮(⭐ / Timestamp),或用你绑定的快捷键
  4. 笔记里会出现可点击的时间链接(格式由模板决定)
  5. 在链接下方写说明,例如:挤出面 + Ctrl+R 环切

点击时间戳会发生什么

在 阅读视图 下点击时间戳,播放器会跳到对应秒数。若点了没反应:先切到阅读模式,或确认播放器仍是「活动」状态。

固定播放器(强烈建议)

避免每点一个链接就新开一堆标签:

  1. 在播放器标签上 右键
  2. 选 固定(Pin)
  3. 之后在不同笔记间切换,仍共用这一个播放器

活动播放器标签上常有红色指示,表示当前笔记命令会控制哪一个播放器。


5. 核心功能二:截图回链

适合记 Blender 界面、节点树、参数面板。

操作步骤

  1. 播到关键画面,暂停
  2. 点播放器上的 截图按钮(📷),或快捷键
  3. 按提示裁剪(若开启)
  4. 图片会保存到库内,并插入当前笔记,通常带「回到该时刻」的链接

之后复习:点图旁时间链接 → 回到原视频位置。

截图文件会占空间;大课建议附件按笔记分文件夹存放。


6. 字幕 / 文稿(Transcript)

若有 .srt / .vtt:

  1. 将字幕文件与视频关联(插件设置或对应命令,以 4.2.7 界面为准)
  2. 可在文稿里搜索关键词
  3. 点击某句字幕可跳转到对应时间
  4. 可复制「带时间戳的引文」进笔记

适合长教程:先搜「Boolean」「Geometry Nodes」,再精看片段。


7. 链接与嵌入语法(进阶)

Media Extended 支持带时间片段的链接/嵌入,常见能力包括:

能力含义
#t=...从某时刻开始
起止时间只播某一段
loop循环该段
autoplay打开时自动播

具体写法以插件文档/设置为准;日常跟课用「时间戳按钮」即可,不必手写。


8. 学 Blender 的推荐工作流(照着做)

第 1 次完整练习(约 15 分钟)

  1. 新建笔记:02 Videos/notes/硬表面入门-01.md
  2. 把教程 mp4 放进 02 Videos/media/,或准备好 YouTube 链接
  3. Open media 打开视频 → Pin 固定播放器
  4. 分栏:左播放器,右笔记
  5. 每学一个操作:暂停 → ⭐ 时间戳 → 写 1 句步骤
  6. 界面难看清时:📷 截一张
  7. 复习时只点时间戳,不必重刷整集

笔记结构示例

# 硬表面入门 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. 参考链接

教程依据官方 README、社区插件页、4.2.7 manifest 与公开使用文档整理。界面文案以你安装的 4.2.7 中英文界面为准。