ABC Music Notation,一款obsidian插件,支持五线谱渲染+播放,无需塞二进制文件
349 字
2 分钟
ABC Music Notation,一款obsidian插件,支持五线谱渲染+播放,无需塞二进制文件
底层用 abcjs 库,支持 abcjs 的全部特性(多声部、和弦、附点、连音线、装饰音、MIDI 乐器切换、Tab 谱等)。代码块语言标识符是 abc,渲染后自带播放按钮。
核心特性
- 🎼 五线谱渲染:在
abc代码块里写文本 → 直接渲染成可读的五线谱 - ▶️ 一键播放:渲染结果自带播放控件(Web Audio API,浏览器内合成音色,无须额外音源)
- 🎹 多声部(合唱/合奏):用
V:声明多个声部,可同时输出 - 🎸 Tab 谱:通过 JSON 配置
tablature,可输出吉他/小提琴等指板谱 - 🎚️ MIDI 乐器切换:
%%MIDI program 24切换音色(钢琴/吉他/鼓…) - 🎵 和弦标记:
"C"在音符上方标和弦名(不影响音符本身) - ⏱️ 速度 / 拍号 / 调号 / 反复 等全部标准 ABC 语法
- 🌗 暗 / 亮模式自适应:跟随 Obsidian 主题
- ⚙️ JSON 高级配置:在代码块顶部写 JSON +
---传给renderAbc(),完整控制 abcjs 选项 - ⚠️ 配置错误保护:JSON 解析失败时仍尝试渲染,并在顶部显示红色错误条
安装
- 社区插件市场(推荐):Settings → Community plugins → Browse → 搜
ABC Music Notation→ Install → Enable。 - 手动安装:从 GitHub Release 下载
main.js/manifest.json/styles.css,放入<vault>/.obsidian/plugins/abcjs/,重启并启用。 - CLI:
obsidian vault=<vault> plugin:install music-code-blocks→plugin:enable music-code-blocks(CLI 支持视版本而定;GUI 万无一失)
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
ABC Music Notation,一款obsidian插件,支持五线谱渲染+播放,无需塞二进制文件
https://chasingblog.site/posts/abc-music-annotation/













