Citation Callouts

approved

by Michael Marvive

Elegantly formats quotes with citations from various sources into custom callouts.

5 stars530 downloadsUpdated 9mo agoMIT
View on GitHub

Citation Callouts

An Obsidian plugin that formats quotes with citations from various sources into beautiful callouts.

Features

  • Smart Book/Source Name Extraction: Automatically extracts the source name from your citation
  • Rich Text Support: Preserves formatting including bold, italic, and hyperlinks
  • Beautiful Callouts: Creates formatted callouts with the book icon and extracted source name as the callout title
  • Multiple Access Methods: Use command palette, ribbon icon, or keyboard shortcut

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins and ensure Safe Mode is OFF
  3. Click Browse and search for "Citation Callouts"
  4. Click Install and then Enable

This plugin is available in the official Obsidian Community Plugin directory.

Usage

  1. Copy content that includes a citation with a URL or source reference
  2. In Obsidian, use one of these methods:
    • Command Palette: Press Ctrl/Cmd + P and search for "Paste as Citation Callout"
    • Ribbon Icon: Click the book icon in the left sidebar
    • Keyboard Shortcut: Assign a custom shortcut in Settings → Hotkeys

Example

Citation Plugin Example

Quote in Clipboard:

The fuel of worship is a true vision of the greatness of God; the fire that makes the fuel burn white hot is the quickening of the Holy Spirit; the furnace made alive and warm by the flame of truth is our renewed spirit; and the resulting heat of our affections is powerful worship, pushing its way out in confessions, longings, acclamations, tears, songs, shouts, bowed heads, lifted hands, and obedient lives.

John Piper, [_Desiring God_](https://ref.ly/logosres/desiringgod?ref=Page.p+82&off=1501&ctx=mplete+our+picture.+~The+fuel+of+worship+) (Sisters, OR: Multnomah Publishers, 2003), 82.

Pasted as Citation Callout:

> [!Citation] Desiring God
> The fuel of worship is a true vision of the greatness of God; the fire that makes the fuel burn white hot is the quickening of the Holy Spirit; the furnace made alive and warm by the flame of truth is our renewed spirit; and the resulting heat of our affections is powerful worship, pushing its way out in confessions, longings, acclamations, tears, songs, shouts, bowed heads, lifted hands, and obedient lives.
> 
> John Piper, [_Desiring God_](https://ref.ly/logosres/desiringgod?ref=Page.p+82&off=1501&ctx=mplete+our+picture.+~The+fuel+of+worship+) (Sisters, OR: Multnomah Publishers, 2003), 82.

Requirements

  • Obsidian v0.15.0 or higher
  • Content with proper citation formatting for best results

Development

Setup

  1. Clone this repository into your vault's plugins folder:

    cd /path/to/your/vault/.obsidian/plugins/
    git clone https://github.com/Marvive/Citation-Callouts.git
    
  2. Install dependencies:

    cd Citation-Callouts
    npm install
    
  3. Build the plugin:

    npm run build
    
  4. Enable the plugin in Obsidian

Scripts

  • npm run dev: Start development with file watching
  • npm run build: Build for production
  • npm run version: Bump version and update files

Support

If you encounter any issues or have feature requests, please create an issue on GitHub.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Michael Marvive - GitHub Profile

License

MIT License


This plugin works best with properly formatted citations that include source references or URLs.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.