Bible Search and Reader
viacai43 downloadsLocal Bible Markdown document search and reading plugin, supporting theme/outline/verse search with focus/parallel/mixed projection modes
- Overview
- Scorecard
- Updates6
Obsidian 插件，用于本地圣经 Markdown 文档的检索、阅读与投影。
目录 / Table of Contents
中文文档
功能特性
- 圣经搜索：支持主题、纲目、经文三种检索类型；可按全部圣经或自定义书卷范围搜索
- 智能检索语法：支持经文出处（
太1:1、路一1～3）、关键词（多词组合匹配）、以及混合检索 - 阅读模式：书卷/章节网格浏览，快速跳转，字体调节，主题与纲目同屏显示
- 投影模式：选中内容后可逐节、并列或混合投影，支持键盘/滚轮/触屏操作
快速开始
安装插件：从 Obsidian 社区插件市场搜索 "Bible Search and Reader" 安装启用；或手动下载解压到
.obsidian/plugins/bible-search-reader/准备圣经文档：下载 圣经文档（ZIP） 并解压到你的仓库
配置目录：Obsidian 设置 → 社区插件 → 圣经检索与阅读 → 分别指定旧约目录和新约目录
📁 路径格式：在 Obsidian 文件列表中，右键点击目标文件夹 →「复制路径」→「从仓库文件夹」，然后粘贴到设置中即可。
💡 如需使用其他版本圣经，可按下方「文档格式」自行整理。
文档格式
文件命名
建议：序号. 书卷名.md，如 01. 创世记.md、40. 马太福音.md。旧约与新约文件分开放置。
内容格式
---
title:
author:
---
> **主题：书卷主题内容**
# 书卷名第1章
> 壹 纲目内容 一1～5
书卷简称1:1 经文内容
书卷简称1:2 经文内容
格式说明
| 类型 | 格式 | 示例 |
|---|---|---|
| 主题 | > **主题：内容** |
> **主题：神的创造** |
| 纲目 | > 纲目内容（以 > 开头，不含"主题"） |
> 壹 神的创造 一1～二3 |
| 经文 | 简称章:节 内容 |
加1:1 作使徒的保罗... |
| 章标题 | # 书卷名第X章 |
# 加拉太书第1章 |
使用指南
搜索
- 点击左侧边栏 📖 图标或运行命令「打开圣经检索」
- 选择检索种类（主题/纲目/经文）和范围，输入内容后点击「🔍 查询」
- 点击结果卡片选中（可排序、标记并列），再点击「逐节/并列/混合投影」
- 点击经文出处可直接跳转到圣经文档对应位置
阅读
- 切换到「圣经阅读」选项卡
- 点击书卷简称 → 章节编号 → 阅读内容
- 使用「快速跳转」下拉框或「上一章/下一章」按钮翻章
- 点击卡片选中内容，可进行复制或投影
投影操作
←/→或空格：翻页+/-：调整字体大小T：切换深色/浅色主题ESC：退出投影
检索语法速查
经文出处
| 输入 | 含义 |
|---|---|
加1:1 |
加拉太书1章1节 |
路一1～3 |
路加福音1章1至3节 |
太1:1-2:5 |
马太福音1章1节至2章5节 |
太1:1, 5 |
马太福音1章1节和1章5节（同书卷延续引用） |
约一1, 十四7~21, 23 |
约翰福音1:1、14:7-21、14:23（混合延续） |
关键词匹配
分隔符决定匹配行为：
| 分隔符 | 模式 | 顺序敏感 | 结果排序 |
|---|---|---|---|
空格 / 顿号 、 |
同时包含（AND） | 否 | 经文顺序 |
逗号 ， , |
同时包含（AND） | 是（按输入顺序） | 经文顺序 |
分号 ； ; |
包含任意（OR） | 是 | 关键词顺序 |
句号 。 . |
包含任意（OR） | 否 | 经文顺序 |
示例：世人 恩典（同时包含，忽略顺序）、世人，恩典（同时包含，按顺序）、世人；恩典（包含任意一个）
注意事项
- 插件启动时自动加载圣经数据，首次加载可能需要几秒
- 修改圣经文档后，重新打开检索视图或重启 Obsidian 即可更新
- 移动端与桌面端均支持
☕ 支持
如果觉得这个插件对你有帮助，可以给予支持，以便继续开发。
加 6:6 — 只是那在话语上受教的，当与施教的人共同分享一切的美物。
许可证
MIT License
English Documentation
⚠️ This plugin currently supports Chinese Bible documents only. All book names, verse reference formats, and search syntax are based on Chinese (Simplified/Traditional). English or other language Bible versions are NOT supported. The English documentation below is provided for reference only.
Features
- Bible Search: Search by Theme, Outline, or Verse; scope can be set to the entire Bible or custom book selections
- Smart Search Syntax: Supports Chinese verse references (e.g.
太1:1,路一1～3), keyword combinations, and mixed queries - Reader Mode: Grid browsing by book/chapter, quick jump, font size adjustment, with themes and outlines displayed alongside verses
- Projection Mode: Selected content can be projected in Focus, Parallel, or Mixed mode; supports keyboard/scroll wheel/touch navigation
Quick Start
Install the plugin: Search for "Bible Search and Reader" in the Obsidian Community Plugins marketplace, or manually download and extract to
.obsidian/plugins/bible-search-reader/Prepare Bible documents: Download the sample Chinese Bible documents (ZIP) and extract them into your vault
Configure directories: Obsidian Settings → Community Plugins → Bible Search and Reader → set the Old Testament Path and New Testament Path
📁 Path format: In the Obsidian file explorer, right-click the target folder → "Copy path" → "From vault folder", then paste it into the plugin settings.
💡 If you need a different Chinese Bible version, you can reformat your own documents following the rules below.
Document Format
File Naming
Recommended: Number. BookName.md, e.g. 01. 创世记.md, 40. 马太福音.md. Old and New Testament files should be placed in separate folders.
Content Format
---
title:
author:
---
> **主题：书卷主题内容**
# 书卷名第1章
> 壹 纲目内容 一1～5
书卷简称1:1 经文内容
书卷简称1:2 经文内容
Format Rules
| Type | Format | Example |
|---|---|---|
| Theme | > **主题：content** |
> **主题：神的创造** |
| Outline | > outline content (starts with >, no "主题") |
> 壹 神的创造 一1～二3 |
| Verse | ShortNameChapter:Verse content |
加1:1 作使徒的保罗... |
| Chapter title | # BookName第X章 |
# 加拉太书第1章 |
Usage Guide
Search
- Click the 📖 icon in the left sidebar or run the command "Open Bible Search"
- Select search types (Theme / Outline / Verse) and scope, enter your query, and click "🔍 Search"
- Click result cards to select (with ordering and side-by-side tagging), then click "Focus / Parallel / Mixed Projection"
- Click a verse reference to jump directly to the corresponding location in the Bible document
Reading
- Switch to the "Bible Reader" tab
- Click a book abbreviation → chapter number → read the content
- Use the "Quick Jump" dropdowns or "Previous / Next Chapter" buttons to navigate
- Click cards to select content for copying or projection
Projection Controls
←/→orSpace: Navigate slides+/-: Adjust font sizeT: Toggle dark/light themeESC: Exit projection
Search Syntax Cheatsheet
Verse References
| Input | Meaning |
|---|---|
加1:1 |
Galatians 1:1 |
路一1～3 |
Luke 1:1–3 |
太1:1-2:5 |
Matthew 1:1 to 2:5 |
太1:1, 5 |
Matthew 1:1 and 1:5 (continuation within same book) |
约一1, 十四7~21, 23 |
John 1:1, 14:7–21, 14:23 (mixed continuation) |
Keyword Matching
The separator determines the matching behavior:
| Separator | Mode | Order Sensitive | Result Sorting |
|---|---|---|---|
Space / 顿号 、 |
AND | No | Verse order |
Comma ， , |
AND | Yes (input order) | Verse order |
Semicolon ； ; |
OR | Yes | Keyword order |
Period 。 . |
OR | No | Verse order |
Examples: 世人 恩典 (contains both, any order), 世人，恩典 (contains both, in order), 世人；恩典 (contains either)
Notes
- The plugin loads Bible data automatically on startup; the first load may take a few seconds
- After modifying Bible documents, reload the search view or restart Obsidian to update
- Supports both desktop and mobile platforms
☕ Support
If you find this plugin helpful, your support is greatly appreciated to continue development.
Galatians 6:6 — Let the one who is taught the word share all good things with the one who teaches.
License
MIT License