JW Library Linker

Instantly create, convert, and enrich Bible references with direct links to JW Library. Type a reference, get a clickable link — it's that simple.

Supported Languages

… and many more. See LOCALIZATION.md for the full list and instructions on adding a new language.

Features

1. Create Bible Reference Links

Type a Bible reference and the plugin creates a markdown link that opens directly in JW Library.

Command mode — type /b followed by a reference:

/b mat 24:14     →  [Matthew 24:14](jwlibrary:///finder?bible=40024014)
/b joh 3:16      →  [John 3:16](jwlibrary:///finder?bible=43003016)

Silent mode — just type the reference directly. Once a valid reference is detected, the suggestion popup appears automatically.

Supported reference formats:

2. Insert Bible Quotes

Fetch actual Bible text from jw.org and insert it directly into your notes.

Three ways to insert quotes:

1. Command palette → "Insert Bible quotes for JW Library links" — processes selected text or the entire note
2. Command palette → "Insert Bible quote at cursor" — inserts a quote for the link at your cursor
3. Right-click on a JW Library link → "Insert Bible quote"

Customizable quote templates:

<!-- Link + quote -->

[Matthew 6:33](jwlibrary:///finder?bible=40006033)

> But keep on seeking first the Kingdom...

<!-- Foldable callout (collapsed by default) -->

> [!quote]- [Matthew 6:33](jwlibrary:///finder?bible=40006033)
> But keep on seeking first the Kingdom...

<!-- Expanded callout -->

> [!quote] [Matthew 6:33](jwlibrary:///finder?bible=40006033)
> But keep on seeking first the Kingdom...

You can also create your own template using the variables {bibleRef}, {bibleRefLinked}, and {quote}.

3. Convert Existing Links

Convert jwpub:// links, publication links, and jw.org web links into jwlibrary:// links that open directly in JW Library.

1. Select text containing links
2. Open the command palette (Ctrl/Cmd + P)
3. Run "Convert links in selection to JW Library links"
4. Choose what to convert:
   • All — Bible verses, publications, and web links
   • Bible — Bible verse links only
   • Publication — Publication links only

4. Link Unlinked Bible References

Have plain-text Bible references in your notes? Convert them all at once.

1. Select text containing references like "John 3:16" or "Romans 8:28"
2. Open the command palette (Ctrl/Cmd + P)
3. Run "Link unlinked Bible references"

The plugin detects valid references and converts them to JW Library links.

Settings

Language

Choose the language for Bible book names and link generation. The plugin UI language follows your Obsidian language setting automatically.

Open Automatically

Moves the "Create link and open" option to the top of the suggestion list, so pressing Enter opens the link in JW Library immediately.

Link Styling

Customize how links appear in your notes:

• Book name length — short (Mat), medium (Matt.), or long (Matthew)
• Prefix/suffix — add text before or after the link (e.g., parentheses)
• Font style — normal, italic, or bold
• Presets — quickly apply common styles like (Mat 3:16) or 📖 Mat 3:16

Language-Independent Links

Omits the language parameter from generated links. Links will open in JW Library's default language instead.

Keep Link Text

When converting existing links, choose whether to preserve the original link text or reformat it using your plugin settings.

Reconvert Existing Links

Re-process already converted jwlibrary:// links with your current formatting settings.

Bible Quote Template

Customize the format of inserted Bible quotes with a live preview. Choose from presets or write your own template.

Commands

Known Issues

Contributing

If you have ideas or want to help improve this plugin, take a look at our contribution guidelines.

Support

If you find this plugin useful, consider buying me a coffee.