太长不看:在 Obsidian 里给 Halo 发带视频的文章只需三步:① frontmatter 写好 halo 发布段(site/name/publish);② 视频先传对象存储拿直链,正文用 video 标签内嵌(贴文内模板,把 MP4_url 换成真实地址);③ 用 Obsidian 的 halo 插件一键发布。宽高比 16:9 的内嵌样式模板可直接复用。

1. 背景:为什么走 Obsidian

Halo 后台自带的编辑器写图文没问题,但一旦正文里要嵌视频就麻烦:视频文件大,走编辑器上传既慢又占博客附件库。我的做法是把视频当作静态资源放进对象存储,正文里只留一个 video 标签引用直链——这样文章本体依旧轻,视频走 CDN 直接流式播放。整个过程在 Obsidian 里完成,写作、贴图、发布一条流水线。

2. 写 frontmatter 发布头

Obsidian 的 halo 插件靠文档头的 frontmatter 识别哪些笔记要发、发到哪。例如本文就是这样的头:

博客配图 配图1

---
title: halo上传视频
slug: haloshang-chuan-shi-pin
cover: ""
categories: []
tags: [obsidian,halo]
halo:
  site: https://www.blog.com
  name: 4a85f38c-c0a5-4e9d-a5b4-488ba1aa3f7d
  publish: true
---

关键字段:site 是博客地址;name 是 halo 插件里配置的站点别名(对应你在插件设置里登记的那台博客);publish: true 表示同步时直接发布,改成 false 则只进草稿箱留人工把关。

3. 正文内嵌视频

先把视频文件传到对象存储,拿到一个可以直接公网访问的 MP4 直链。然后在正文里贴入下面的模板,把 MP4_url 替换成真实地址(例如 https://你的对象存储域名/blog/video/xxx.mp4):

<video src="MP4_url" controls style=" width: 100%; height: auto; aspect-ratio: 16 / 9; display: block; margin: 0; padding: 0; " ></video>

这串样式做了三件事:宽度撑满正文列、高度按 16:9 自适应、独立成块不与文字混排。视频文件名建议用英文或拼音——部分对象存储对中文文件名的 URL 处理需要额外转义,直链里一长串 %E6%95%B0 既难看也容易在搬运中出错。

下面就是按这个模板内嵌的效果:

4. 插件一键发布

配置好发布头、贴好视频之后,用 Obsidian 的 halo 插件执行发布即可,剩下的建文、挂标签、上线动作由插件完成。

5. 验证与踩坑

发布后必做两个检查:一是文章页里视频能不能直接播放(重点看移动端,controls 属性在移动浏览器上的样式略有差异);二是视频直链跨域策略——如果对象存储开了防盗链或 CORS 限制,记得把博客域名加进白名单,否则会出现「电脑能放、手机不能放」的玄学现象。另外视频别指望封面:cover 字段留空时博客会走随机封面图,想要视频首帧当封面得单独截图上传再填地址。

6. 小结

视频直链 + video 标签 + frontmatter 三件套,让「写带视频的博客」和「写纯文字」的成本几乎一样。配合前面自动发布的文章里提到的流水线,从笔记到上线仍然是一条命令的事。