README file from
GithubWOL Reference Tools
An Obsidian plugin that lets you look up Bible verses and references from wol.jw.org, and add them to your notes inline, in a modal or popover, or in the sidebar.
How it works
ℹ️ The plugin sends the 'value' of the reference - whatever is within the !!, and send that value to a Cloudflare worker, which does a search on wol.jw.org, eg: [https://wol.jw.org/en/wol/l/r1/lp-e?q=ps83:18](https://wol.jw.org/en/wol/l/r1/lp-e?q=ps83:18). It then uses cheerio to parse the HTML, and returns an object containing the reference text and the verse text.
{
"results": [
"<p class=\"line\"><span class=\"verse\"><span class=\"verse-number\">18 </span>May people know that you, whose name is Jehovah,</span></p><p class=\"line-secondary\"><span class=\"verse\">You alone are the Most High over all the earth.</span></p>"
]
}
Some light formatting is applied for styling purposes, but the results are left otherwise unchanged.
How to use
Wrap any reference in !!double exclamation marks!! and it becomes a clickable link. Click it to see the full text from wol.jw.org in a modal or popover. The sidebar panel automatically lists and loads all references in the active note.
To show a verse inline within your note as you're typing, add a > after the double exclamation marks:
!!John 3:16!!>
Add scriptures to your frontmatter using the double exclamation marks and combine that with a dataviewjs query to show any references you've added:
---
scriptures:
- "!!Daniel 12:1!!"
- "!!Revelation 12:7, 9!!"
---
const scriptures = dv.current().scriptures ?? [];
scriptures.forEach(s => dv.paragraph(s + "> <br />"));

Features
- Inline reference links —
!!John 3:16!!renders as a styled, clickable link in both Reading and Live Preview modes - Modal & popover display — choose how results appear (configurable in settings)
- Sidebar panel — all references in the current note are fetched and displayed in the right panel
- Inline callout —
!!John 3:16!!>renders the full result as an inline block directly in the editor - In-memory caching — results are cached for 30 minutes per session to avoid redundant requests
Usage
| Syntax | Result |
|---|---|
!!John 3:16!! |
Clickable inline link; click to open result |
!!Isaiah 40:8!! |
Works for any Bible book or WOL search term |
!!John 3:16!!> |
Renders result inline as a callout block |
!!John 3:16; Romans 8:28!! |
Semicolons separate multiple refs in one marker |
Settings
| Setting | Description |
|---|---|
| Reference Display Option | Choose Modal Dialog or Pop-over for click behaviour |
| Reference cache | Clear the in-memory cache to force fresh fetches |