Obsidian Citation Guide
A skill for using the Obsidian Citation Plugin to integrate bibliographic references from BibTeX or CSL-JSON files into the Obsidian knowledge management workflow. Based on obsidian-citation-plugin (1K stars), this skill enables researchers to create literature notes, insert citations, and build interconnected knowledge bases grounded in their reference libraries.
Overview
Academic researchers need their notes to be deeply connected to their references. The Obsidian Citation Plugin bridges BibTeX or CSL-JSON bibliography files with Obsidian's note-taking system, enabling seamless creation of literature notes from reference entries, quick citation insertion while writing, and automatic backlinking between notes and their source references.
Unlike Zotero-specific integrations, this plugin works with any tool that exports standard BibTeX or CSL-JSON, making it compatible with Zotero, JabRef, Mendeley, EndNote, and even hand-crafted .bib files.
Setup and Configuration
Prerequisites
- Obsidian with community plugins enabled
- A BibTeX (.bib) or CSL-JSON (.json) bibliography file
- The bibliography file should be accessible from the Obsidian vault directory
Installation
- Open Obsidian Settings and navigate to Community Plugins
- Search for "Citations" in the plugin browser
- Install the Citations plugin and enable it
- Navigate to the plugin settings to configure your bibliography source
Configuration
- Set the path to your .bib or .json bibliography file
- Configure the literature note folder (e.g.,
references/ or literature/)
- Set the literature note template with desired frontmatter fields
- Define the citation format for in-text insertions
- Configure the citation key format used for note file names
Template Variables
{{citekey}} - the unique citation key for the reference
{{title}} - the full title of the work
{{authorString}} - formatted author list
{{year}} - publication year
{{abstract}} - the abstract if available in the bibliography
{{DOI}} - Digital Object Identifier
{{URL}} - web link to the publication
{{containerTitle}} - journal or conference name
{{page}} - page numbers
{{tags}} - keywords or tags from the bibliography entry
Core Workflows
Creating Literature Notes
- Use the command palette to open the citation picker
- Search by author, title, year, or any metadata field
- Select a reference to create a new literature note from the template
- The note is populated with metadata from the bibliography entry
- Add your own annotations, summaries, and connections to the note
Inserting Citations
- While writing in any Obsidian note, trigger the citation insertion command
- Search and select the desired reference
- The citation is inserted in the configured format (e.g.,
[@citekey], [[@citekey]])
- Citations create automatic backlinks to the corresponding literature notes
- Multiple citation formats can be configured for different output targets
Browsing References
- Open the citation panel to browse your entire bibliography
- Filter by type (article, book, chapter, conference), year, or author
- Preview reference details without creating a note
- Quickly jump to existing literature notes for any reference
- Identify references that do not yet have corresponding notes
Literature Note Strategies
Minimal Notes (Quick Reference)
- Include only the frontmatter metadata (citekey, title, authors, year)
- Add a single-paragraph summary of the paper's contribution
- Tag with 2-3 topic tags for filtering
- Useful for references that provide supporting context but are not central to your work
Standard Notes (Working Knowledge)
- Include full metadata frontmatter
- Add sections for: summary, key findings, methodology, strengths, limitations
- Extract 3-5 key quotes with page references
- Link to related literature notes and concept notes
- Tag with topic, method, and status tags
Deep Notes (Core References)
- Include everything from standard notes plus:
- Detailed methodology breakdown with your assessment
- Figure and table descriptions with your interpretation
- Questions and ideas prompted by the paper
- Connections to your own research with specific implications
- Reading timeline notes tracking your evolving understanding
Building a Connected Knowledge Base
Linking Strategies
- Link literature notes to concept notes that represent key ideas
- Create MOC (Map of Content) notes that curate references by theme
- Use tags consistently to enable cross-cutting queries
- Link literature notes to project notes where the reference is cited
- Create methodology notes that reference the papers using each method
Dataview Integration
- Use the Dataview plugin to create dynamic literature dashboards
- Query literature notes by tag, date, status, or any frontmatter field
- Generate reading lists filtered by topic and reading status
- Create citation frequency tables showing your most-used references
- Build project-specific reference lists from linked literature notes
Graph View Usage
- The Obsidian graph view shows the link structure between all notes
- Clusters of densely linked literature notes indicate research themes
- Isolated literature notes may need more connections or may be peripheral
- Hub notes (with many connections) are candidates for synthesis writing
- Use the graph to discover unexpected connections between research areas
Multi-Tool Workflows
Zotero to Obsidian Pipeline
- Export from Zotero via Better BibTeX to keep the .bib file continuously updated
- The citation plugin detects changes to the .bib file automatically
- Create literature notes in Obsidian for papers annotated in Zotero
- Use Zotero for PDF management and Obsidian for knowledge synthesis
- This separation leverages the strengths of each tool
Writing Pipeline
- Draft manuscripts in Obsidian using Pandoc-compatible citation syntax
- Use Pandoc to compile Markdown to LaTeX, DOCX, or HTML with formatted citations
- The citation keys in your notes map directly to your bibliography file
- Generate bibliographies automatically from cited references
- This pipeline supports any citation style via CSL
Integration with Research-Claw
This skill enhances the Research-Claw knowledge management workflow:
- Create literature notes programmatically from search results
- Build connected knowledge bases that inform writing and analysis tasks
- Enable citation insertion during AI-assisted manuscript drafting
- Connect with other Obsidian and Zotero skills for comprehensive workflows
- Support systematic review note-taking with structured templates
Best Practices
- Keep your bibliography file in the Obsidian vault for reliable path resolution
- Use a consistent citation key format across all tools in your workflow
- Create literature notes soon after reading to capture fresh insights
- Review and update literature notes periodically as your understanding deepens
- Use templates to ensure consistent structure across all literature notes
- Back up both the bibliography file and the vault regularly
1---2name: obsidian-citation-guide3description: Citation plugin for Obsidian note-taking with BibTeX support4---5
6# Obsidian Citation Guide
7
8A skill for using the Obsidian Citation Plugin to integrate bibliographic references from BibTeX or CSL-JSON files into the Obsidian knowledge management workflow. Based on obsidian-citation-plugin (1K stars), this skill enables researchers to create literature notes, insert citations, and build interconnected knowledge bases grounded in their reference libraries.
9
10## Overview
11
12Academic researchers need their notes to be deeply connected to their references. The Obsidian Citation Plugin bridges BibTeX or CSL-JSON bibliography files with Obsidian's note-taking system, enabling seamless creation of literature notes from reference entries, quick citation insertion while writing, and automatic backlinking between notes and their source references.
13
14Unlike Zotero-specific integrations, this plugin works with any tool that exports standard BibTeX or CSL-JSON, making it compatible with Zotero, JabRef, Mendeley, EndNote, and even hand-crafted .bib files.
15
16## Setup and Configuration
17
18**Prerequisites**
19- Obsidian with community plugins enabled
20- A BibTeX (.bib) or CSL-JSON (.json) bibliography file
21- The bibliography file should be accessible from the Obsidian vault directory
22
23**Installation**
24- Open Obsidian Settings and navigate to Community Plugins
25- Search for "Citations" in the plugin browser
26- Install the Citations plugin and enable it
27- Navigate to the plugin settings to configure your bibliography source
28
29**Configuration**
30- Set the path to your .bib or .json bibliography file
31- Configure the literature note folder (e.g., `references/` or `literature/`)
32- Set the literature note template with desired frontmatter fields
33- Define the citation format for in-text insertions
34- Configure the citation key format used for note file names
35
36**Template Variables**
37- `{{citekey}}` - the unique citation key for the reference
38- `{{title}}` - the full title of the work
39- `{{authorString}}` - formatted author list
40- `{{year}}` - publication year
41- `{{abstract}}` - the abstract if available in the bibliography
42- `{{DOI}}` - Digital Object Identifier
43- `{{URL}}` - web link to the publication
44- `{{containerTitle}}` - journal or conference name
45- `{{page}}` - page numbers
46- `{{tags}}` - keywords or tags from the bibliography entry
47
48## Core Workflows
49
50**Creating Literature Notes**
51- Use the command palette to open the citation picker
52- Search by author, title, year, or any metadata field
53- Select a reference to create a new literature note from the template
54- The note is populated with metadata from the bibliography entry
55- Add your own annotations, summaries, and connections to the note
56
57**Inserting Citations**
58- While writing in any Obsidian note, trigger the citation insertion command
59- Search and select the desired reference
60- The citation is inserted in the configured format (e.g., `[@citekey]`, `[[@citekey]]`)
61- Citations create automatic backlinks to the corresponding literature notes
62- Multiple citation formats can be configured for different output targets
63
64**Browsing References**
65- Open the citation panel to browse your entire bibliography
66- Filter by type (article, book, chapter, conference), year, or author
67- Preview reference details without creating a note
68- Quickly jump to existing literature notes for any reference
69- Identify references that do not yet have corresponding notes
70
71## Literature Note Strategies
72
73**Minimal Notes (Quick Reference)**
74- Include only the frontmatter metadata (citekey, title, authors, year)
75- Add a single-paragraph summary of the paper's contribution
76- Tag with 2-3 topic tags for filtering
77- Useful for references that provide supporting context but are not central to your work
78
79**Standard Notes (Working Knowledge)**
80- Include full metadata frontmatter
81- Add sections for: summary, key findings, methodology, strengths, limitations
82- Extract 3-5 key quotes with page references
83- Link to related literature notes and concept notes
84- Tag with topic, method, and status tags
85
86**Deep Notes (Core References)**
87- Include everything from standard notes plus:
88- Detailed methodology breakdown with your assessment
89- Figure and table descriptions with your interpretation
90- Questions and ideas prompted by the paper
91- Connections to your own research with specific implications
92- Reading timeline notes tracking your evolving understanding
93
94## Building a Connected Knowledge Base
95
96**Linking Strategies**
97- Link literature notes to concept notes that represent key ideas
98- Create MOC (Map of Content) notes that curate references by theme
99- Use tags consistently to enable cross-cutting queries
100- Link literature notes to project notes where the reference is cited
101- Create methodology notes that reference the papers using each method
102
103**Dataview Integration**
104- Use the Dataview plugin to create dynamic literature dashboards
105- Query literature notes by tag, date, status, or any frontmatter field
106- Generate reading lists filtered by topic and reading status
107- Create citation frequency tables showing your most-used references
108- Build project-specific reference lists from linked literature notes
109
110**Graph View Usage**
111- The Obsidian graph view shows the link structure between all notes
112- Clusters of densely linked literature notes indicate research themes
113- Isolated literature notes may need more connections or may be peripheral
114- Hub notes (with many connections) are candidates for synthesis writing
115- Use the graph to discover unexpected connections between research areas
116
117## Multi-Tool Workflows
118
119**Zotero to Obsidian Pipeline**
120- Export from Zotero via Better BibTeX to keep the .bib file continuously updated
121- The citation plugin detects changes to the .bib file automatically
122- Create literature notes in Obsidian for papers annotated in Zotero
123- Use Zotero for PDF management and Obsidian for knowledge synthesis
124- This separation leverages the strengths of each tool
125
126**Writing Pipeline**
127- Draft manuscripts in Obsidian using Pandoc-compatible citation syntax
128- Use Pandoc to compile Markdown to LaTeX, DOCX, or HTML with formatted citations
129- The citation keys in your notes map directly to your bibliography file
130- Generate bibliographies automatically from cited references
131- This pipeline supports any citation style via CSL
132
133## Integration with Research-Claw
134
135This skill enhances the Research-Claw knowledge management workflow:
136
137- Create literature notes programmatically from search results
138- Build connected knowledge bases that inform writing and analysis tasks
139- Enable citation insertion during AI-assisted manuscript drafting
140- Connect with other Obsidian and Zotero skills for comprehensive workflows
141- Support systematic review note-taking with structured templates
142
143## Best Practices
144
145- Keep your bibliography file in the Obsidian vault for reliable path resolution
146- Use a consistent citation key format across all tools in your workflow
147- Create literature notes soon after reading to capture fresh insights
148- Review and update literature notes periodically as your understanding deepens
149- Use templates to ensure consistent structure across all literature notes
150- Back up both the bibliography file and the vault regularly