Obsidian Bible Reference

• Simplify your Bible Study note-taking experience with the user-friendly Obsidian.md notes app.
• Experience the seamless assistance of automated Bible Verse suggestions for effortless referencing.

These contributions will be highly appreciated in supporting the development of the project. 👍

• 👉 Star the Project
• ☕️ Buy me a coffee @Github Sponsor
• ❤️ Provide Feedback in Issues or join Discussion

---

About

How to use

1. Open a note in Obsidian.md application
2. In a note, for example type --John1:1
3. Select the suggestion

Type --John1:a to insert all verses in a chapter (a = the whole chapter).

You can also get a "verse of the day" by typing --vod.

Polish translations are available as well, including UBG (Uwspółcześniona Biblia Gdańska) and BG (Biblia gdańska).

Read more about How to use

On iOS devices, there is a known issue about conflict between Smart Punctuation and double hyphens --.

To make it work,

• you can use ++ instead of -- in the beginning of the verse reference => ++John1:1 (recommended)
• or you can turn Smart Punctuation off => How to use

Contribution and Credits 🙏

• All different kinds of contributions are welcome, see: How to Contribute
• Credits: Bible API/Data Source Providers

---

Sponsors and Contributors ✨

Thanks goes to these wonderful people (emoji key):

Chris Gonzales 💵 🤔	Jeremy Treis 💻 🐛 🤔	minermaniac447 💻	Brennen Puth 💻 🤔	Joey Kilgore 💻	Ben Vanderhoff 📖	Bill Chen 💻
GScriptS 💻 🌍	Aaron Friedel 💻	benjayahari 🌍	George 🌍	Nathan 💻	Karl Fischer 🌍	OfirSinn 🌍
Pavel Diatchenko 💻	Joshua Stoll 💻 🌍	blankton2 🌍	abbasou 💻	AlphaHasher 💻 🌍	jonathanvanschenck 💻	Adam W 🌍 💻
Redster1 🐛	David Bergan 💵	Benedictteo05 💻	José Soares 💻	Willi Richert 💻	cabbott008 💻	zenibako 💻
Michael Marvive 💻	Jonathan Fisher 💻	Hanjo Kim 💻

Special thanks for the sponsors

Related Projects

• Bible Vector Search To search Bible verses in meaning not in keywords. This is another open source project I built recently to implement AI Embedding and Vector Search for Bible verses (in BBE translation).

Packages in this Monorepo

This repository is a Bun workspace monorepo. The repository root doubles as the installable Obsidian plugin folder (manifest.json, versions.json, styles.css, and the built main.js live at the root), while all source lives under packages/:

• obsidian-bible-reference — the Obsidian plugin source (this README documents it). Its build emits main.js to the repository root.
• bible-reference-toolkit — Normalize Bible references, convert them to machine-readable formats, query and manipulate them.
• bible-book-names-intl — Bible book names in multiple languages (the source used to resolve non-English book names).

Development

bun install          # install all workspace deps
bun run build        # build the plugin (main.js -> repo root)
bun run dev          # watch build
bun test             # run all package tests
bun run lint         # lint the plugin package