Bible Study — Obsidian 圣经研读插件

在 Obsidian 中快速引用、阅读、浏览圣经（和合本 CUV 简体中文）。

功能

功能	说明
简化输入	输入 太5 6 这类简写，按 Enter 自动补全 马太福音 5:6，使用范围命令增减经节
经文引用	完整经文如 马太福音 5:6，再按 Enter 自动插入对应经文，点击可跳转到圣经阅读面板
阅读面板	右侧栏圣经阅读器，卷/章多列选择器，多套阅读主题
手机友好	支持 Enter 补全和展开经文，可将范围增减命令添加到移动工具栏

使用方式

补全和展开经文

支持的简化输入格式：

太5 6                       → 马太福音 5:6
约 5 5 6                    → 约翰福音 5:5-6（空格三段式）
yh 3:16                     → 约翰福音 3:16（拼音首字母）
约3 16,3 17 18,4 1          → 约翰福音 3:16, 3:17-18, 4:1（多段引用）

示例：两步展开

输入 太5 6，光标停在引用内，然后：

步骤	操作	效果
①	按 Enter（或 Tab）	太5 6 → 马太福音 5:6（补全书名，变成标准名）
②	再按 Enter	在 马太福音 5:6 下方插入第 6 节经文

马太福音 5:6
    虚心的人有福了！因为天国是他们的。

调整范围（光标停在引用上时）：

按键	效果
Alt+]	追加下一节：马太福音 5:6 → 马太福音 5:6-7，并追加第 7 节经文
Alt+[	退回一节：马太福音 5:6-8 → 马太福音 5:6-7，并删除第 8 节
点击引用	打开面板并跳转到对应章节

手机端可在 设置 → 移动端 → 配置移动工具栏 中添加“经文范围增加一节”和“经文范围减少一节”命令。使用时将光标放在引用内，再点击对应工具栏按钮。

阅读面板

• 点击 📖 图标切换面板（再点关闭）
• 卷/章多列网格选择器（卷 5 列、章 10 列）
• 5 套阅读主题，面板底部下拉切换
• 支持拖选文本复制（Ctrl+C），双击经文复制整节引用
• ← → 方向键翻章
• 点击引用链接 → 打开面板并跳转到节

命令

命令	快捷键
经文范围增加一节	Alt+]
经文范围减少一节	Alt+[

安装

社区插件（推荐）

在 Obsidian 设置 → 第三方插件 → 浏览 → 搜索 "Bible Study" 安装。

手动安装

1. 下载 最新 Release
2. 将 main.js、manifest.json、styles.css 放入 .obsidian/plugins/bible-study/
3. 重启 Obsidian，关闭安全模式并启用插件

开发

npm install
npm run dev     # 开发模式
npm run build   # 生产构建

致谢

• 圣经数据：thiagobodruk/bible
• 繁简转换：opencc-js

---

English

A Bible study plugin for Obsidian. Quickly reference, read, and browse Bible verses (CUV, Simplified Chinese).

Features

Feature	Description
Simplified Input	Type a shorthand like 太5 6, press Enter to auto-fill 马太福音 5:6, then use the range commands to add or remove verses
Verse Quote	Type a full reference like 马太福音 5:6, press Enter to insert the verse; click to jump to the reading panel
Reading Panel	Right-sidebar reader with multi-column book/chapter pickers and multiple reading themes
Mobile Friendly	Enter-based completion and expansion, with range commands available from the mobile toolbar

Usage

Inline References

A reference can be written in 2 ways, both of which are recognized:

Form	Notes
马太福音 5:6	Plain text, auto-recognized
*马太福音 5:6*	Legacy *...* form (kept for compatibility)

Example: two-step expansion

Type 太5 6, keep the cursor inside the reference:

Step	Action	Result
1	Press Enter (or Tab)	太5 6 → 马太福音 5:6 (fills in the full book name and becomes a plain reference)
2	Press Enter again	Inserts verse 6 below 马太福音 5:6

马太福音 5:6
> 〔6〕虚心的人有福了！因为天国是他们的。

Adjusting the range (cursor on the reference):

Key	Result
Alt+]	Appends next verse: 马太福音 5:6 → 马太福音 5:6-7, inserting verse 7
Alt+[	Shrinks back: 马太福音 5:6-8 → 马太福音 5:6-7, removing verse 8
Click reference	Opens panel and navigates to the verse

On mobile, open Settings → Mobile → Configure mobile toolbar, then add Extend Bible Reference Range and Shrink Bible Reference Range. Place the cursor inside a reference before tapping either action.

太5:6                    → 马太福音 5:6
约3:16,3:17-18,4:1       → 约翰福音 3:16, 3:17-18, 4:1 (multi-reference)
jhn 3:16                 → 约翰福音 3:16 (English abbreviation)
马太福音 5:6             → plain text reference, auto-recognized

Reading Panel

• Click 📖 ribbon icon to toggle
• Multi-column book/chapter pickers (5 columns for books, 10 for chapters)
• 5 reading themes, switchable from a footer dropdown
• Select any text and Ctrl+C; double-click a verse to copy the full reference
• ← → arrow keys to navigate chapters
• Click reference link → navigate to specific verse

Settings

• Inline expand toggle, expand key (Tab/Enter/both)
• Default version, verse display options, font size, reading theme

Commands

Command	Hotkey
Insert / Expand Reference	—
Toggle Reading Panel	—
Extend Bible Reference Range	Alt+]
Shrink Bible Reference Range	Alt+[

Installation

Community Plugin (Recommended)

Obsidian → Settings → Community Plugins → Browse → "Bible Study".

Manual

1. Download latest Release
2. Copy main.js, manifest.json, styles.css to .obsidian/plugins/bible-study/
3. Restart Obsidian, disable restricted mode, and enable the plugin

Bible Data

The plugin bundles complete CUV Bible data (compressed, ~1.1MB). No network needed after installation.

Development

npm install
npm run dev     # Watch mode
npm run build   # Production build

Credits

• Bible data: thiagobodruk/bible
• Chinese conversion: opencc-js

License

MIT