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

功能

使用方式

补全和展开经文

支持的简化输入格式：

-太5 6                      → 马太福音 5:6（以 `-` 开头触发识别）
！太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，光标停在引用内，然后：

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

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

阅读面板

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

命令

安装

社区插件（推荐）

在 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

Usage

Inline References

A reference can be written in 3 ways, all of which are recognized:

Example: two-step expansion

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

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

Adjusting the range (cursor on the reference):

-马太福音 5:6            → 马太福音 5:6 (removes -)
-约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

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