Obsidian Stats logoObsidian Stats

Bible Study

by linkongren
5
4
3
2
1
Score: 30/100
Install Code

Description

Reviews

No reviews yet.

Stats

0
stars
212
downloads
0
forks
35
days
12
days
12
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
1
total issues
1
open issues
0
closed issues
47
commits

Latest Version

1.4.2
12 days ago

Changelog

Fix Obsidian review findings: API compatibility, safe data handling, and no default hotkeys.

See all version on GitHub

README file from

Github

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   # 生产构建

致谢

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

License

MIT

Sponsors