Jorrit van der Heide149 downloadsExport a note to Word, PDF or LaTeX through pandoc, with its links turned into real citations.
Export a note to Word, PDF, Markdown or LaTeX through pandoc, with its links turned into real citations.
Works well with Paper Trail, which turns your Zotero library into a reading queue, with a note for each paper, and In the Open, which publishes a note to your website. See Works well with.

In your vault, a citation can simply be a link: [[marsh2024]]. It opens the
paper, shows a preview when you hover over it, and the paper's backlinks show
everywhere you cited it. But the moment your chapter has to go to your
supervisor as a Word file, that link means nothing. It's a dead link to a note
on your laptop.
Due Credit gets your writing out of the vault with its citations intact. It runs pandoc on your note to turn your links into real citations, with a reference list in the citation style you choose. Anything that only makes sense in Obsidian, like your comments and tags, stays behind.
.bib file from Zotero with
Better BibTeX's auto-export
turned on, so it stays up to date as you add papers. Without one, links
export as plain text.Due Credit needs Obsidian 1.13 or later, on desktop.
.bib file. The default is
Literature/library.bib in your vault, and a file outside the vault works
too, starting with / or ~.As [[marsh2024]] shows, …. Typing the link
yourself works just as well.If a link is about to come out as plain text instead of a citation, Due Credit tells you before it exports. See Before the export.
Due Credit cites from your .bib, and doesn't make a note for each paper. A
link cites the paper either way, note or not. For a note per paper, use
Paper Trail, or click the link to make one yourself.

Due Credit reads your notes, and the only thing it writes in them is a citation you ask for. An export only writes the file you pick in the save dialog. It refuses any place inside your vault, so an export can never replace a note. What you wrote for yourself never leaves. Comments are stripped, and only a handful of properties, like the author and date, go into the file. Section 11 lists exactly what it reads and writes.
It only connects to the internet to download the built-in pandoc, when you have no pandoc installed and say yes. The only program it starts is an installed pandoc. The built-in one runs inside Obsidian.
The health report in Obsidian's plugin directory warns about two things. Both are part of how the export works:
Every change is tested. Every release is built in public on GitHub, and you can check that the file you installed is the one GitHub built. Section 11.5 shows how.
If you want to work on the plugin, or use its pandoc filter on its own:
\cite commands, ready for a journal's
or conference's own class.[[citekey]], linked to the paper's note when it has one. Press Tab in the
picker to add a page.[[marsh2024]] becomes "(Marsh 2024)", with a
reference list at the end.apa, or a
.csl file, including footnote styles.citekey property
cites that key, even after Better BibTeX changed it.%%…%% and <!-- … --> never leave the vault.Before pandoc runs, Due Credit removes or rewrites everything that only makes sense inside Obsidian:
| In your note | In the export |
|---|---|
%%comment%%, <!-- comment --> |
Left out. They're for you. |
^abc123 block IDs |
Left out. |
| An H1 on the first line | The document's title. Without one, the title property, then the file name. Every other heading moves up a level, unless the note uses H1 for its own sections. |
| Properties | Only author, date, lang, abstract, keywords, subtitle and reference-section-title go along. |
![[figure.png|300]], ![[figure.png|A chart|300]] |
The image, 300 pixels wide. |
 |
The image, wherever it is in your vault, as Obsidian finds it. |
An image with *Sales by month.* on the line right under it |
A figure, with "Sales by month." as its caption. An image on its own gets no caption: its alt text is for readers who can't see it. A Markdown export keeps the image and the line in italics as you wrote them. |
| An embedded note, PDF or canvas | Left out. It only works inside your vault. |
dataview, dataviewjs, tasks, query and base blocks |
Left out. Outside Obsidian, they'd only show their query. |
> [!note] Title |
A quote with the title in bold. A callout without a title is a plain quote. |
| One newline | A line break, as Obsidian shows it, unless you turned on strict line breaks. |
A backslash, like C:\path\x |
As written, as Obsidian shows it. Before a space, pandoc reads one as a space that doesn't break, so write \\ for a backslash there. LaTeX meant for a PDF, like \newpage, goes in as `\newpage`{=latex}. |
[Smith](smith-2017.md) or [Smith](smith-2017), a Markdown link to a note |
The same as [[smith-2017|Smith]], so a link to a paper note is a citation. |
==highlight== |
Highlighted in Word, PDF and Markdown. Plain text in LaTeX. |
[^1] and ^[inline] footnotes |
Footnotes, read the way Obsidian reads them. |
A line of #tags |
Left out. A tag in a sentence stays as its word: #project/alpha becomes "project/alpha". |
The reference list is headed References, or Bibliography under a style that
cites in footnotes. To call it something else, like Literatuur in a Dutch text,
set reference-section-title in the note's properties.
A link becomes a citation when your bibliography has an entry with that key. Everything pandoc can put in a citation goes in the link's label, around the key:
| You write | It exports as |
|---|---|
[[marsh2024]] |
(Marsh 2024) |
[[marsh2024|marsh2024, p. 12]] |
(Marsh 2024, 12) |
[[marsh2024|see marsh2024, p. 12]] |
(see Marsh 2024, 12) |
[[marsh2024|Marsh, p. 12]] |
(Marsh 2024, 12) |
[[marsh2024]]; [[okafor2019]] |
(Marsh 2024; Okafor 2019) |
[[My idea|this idea]] |
this idea |
A link to one of your own notes isn't in your bibliography, so it exports as
its words, like the last row. Your reader gets the text, without a link that
leads nowhere. Pandoc's way of writing a citation, [@marsh2024, p. 12], works
too.
Don't put your own parentheses around a citation. The export adds them, and
([[marsh2024]]) would come out as "((Marsh 2024))".
When your sentence already names the author, put a - against the key to
leave the author out of the citation:
| You write | It exports as |
|---|---|
Marsh [[marsh2024|-marsh2024, p. 12]] argues |
Marsh (2024, 12) argues |
As @marsh2024 argues |
As Marsh (2024) argues |
Under a style that cites in footnotes, this works a little differently. See Footnote styles.
A paper note doesn't have to be named after its key. If the note
Marsh (2024) The Quiet Archive has citekey: marsh2024 in its properties, a
link to it comes out as (Marsh 2024). And when Better BibTeX changes a key,
links made before still cite the paper, as soon as the note's property has the
new key.
Paper Trail writes the
property for you.
Before an export runs, Due Credit lists every link that's about to come out as plain text instead of a citation:
You can export anyway, or go and fix them first. A link to a note of your own is never listed.
For more, like footnote styles, LaTeX, and using the filter with pandoc on its own, see Citations in the docs and the FAQ.
None of the commands come with a hotkey, so they won't clash with the ones you already use. You can set your own in Settings → Hotkeys.
Due Credit: Insert citation - Picks a paper from your bibliography and
writes a link to it at the cursor. Tab instead of Enter asks for a page.Due Credit: Add page to citation - Adds a page to the citation at the
cursor, or the one just before it. That's where the cursor ends up after you
pick a note from Obsidian's [[ suggestions.Due Credit: Toggle author in citation - Leaves the author out of the
citation at the cursor, for when your sentence already names them. Run it
again to put them back.Due Credit: Export to Word - A .docx with citations and a reference list.Due Credit: Export to PDF - The same, typeset with xelatex.Due Credit: Export to Markdown - Plain Markdown under its title, with
citations, for pasting elsewhere.Due Credit: Export to LaTeX - A body with \cite commands, for a journal's
or conference's class.Each export is also on a note's right-click menu, in the file explorer or on its tab, so you can export a note without opening it.
Pandoc
| Setting | Default | |
|---|---|---|
| Pandoc | pandoc |
If you installed pandoc, this can usually stay pandoc. If Due Credit doesn't find it, give its full path. Without pandoc installed, Due Credit offers to download a copy that runs inside Obsidian, for Word, Markdown and LaTeX. A PDF needs pandoc installed, and xelatex, which comes with any TeX distribution. |
| Pandoc arguments | None | Added to every export, like --toc, --number-sections, -V geometry:margin=2.5cm or, with pandoc installed, --filter pandoc-crossref. A filter of yours runs after Due Credit's own and before the citations are formatted. Put quotes around a value with spaces. ~ is your home folder, and a relative path starts from your vault. A --bibliography here is checked before an export, as the Bibliography setting is. Due Credit can't pass on an argument that changes where the file goes, how the note is read or the format, and if you add one, it says so here. |
| Output folder | ~/Documents |
Where the save dialog opens the first time you export. After that, it opens where your last export went, until you change this. |
| Word template | Pandoc's own | A .docx with the fonts, headings and margins your university or journal wants, for Word exports to use. Leave it empty for pandoc's default styles. |
Citations
| Setting | Default | |
|---|---|---|
| Bibliography | Literature/library.bib |
The .bib file that Better BibTeX's auto-export keeps up to date. A link to one of its keys exports as a citation, and any other link as its text. The file can be in your vault, or outside it with a path starting with / or ~. Leave it empty to export without citations, unless a --bibliography under Pandoc arguments gives one. |
| Papers folder | Literature |
The folder with your paper notes. Before an export, Due Credit lists every link to a paper note whose key isn't in your bibliography. |
| Citation key property | citekey |
The property that holds a paper note's citation key. A link to a note with one cites that key, whatever the note is called. |
| Citation style | Chicago author-date | A style Zotero has installed, such as apa, or the path to a .csl file. |
A setting that has to agree with your vault or your computer says so right under it, in the settings: a bibliography, Word template or style that isn't there, an argument Due Credit can't pass on, a papers folder with no notes in it, or a citation key property no note has.
I made these too. Each one does one thing and works on its own, but they fit together nicely.
Paper Trail turns your Zotero library into a reading queue, with a note for each paper. With Better BibTeX, each note is named after its citation key, and Insert citation links to those notes, so every place you cite a paper turns up in its backlinks.
With Better BibTeX, Paper Trail also gives each paper note the citekey
property, which keeps your citations working when Better BibTeX changes a key.
Without it, the notes have no key, so a link to one exports as plain text. And its Insert
annotation quotes a passage you highlighted, with a citation Due Credit
reads.
Paper Trail helps you read the papers, and Due Credit helps you cite them and get the chapter out of your vault.
In the Open publishes a note as a post on your own website, if your site takes Micropub, an open standard for posting to a website. It reads a note the same way Due Credit does, with the same code, and turns your links into citations with a reference list.
Give both plugins the same Bibliography and Citation style. A chapter you export and a blog post you publish from it then cite the same way, and your comments stay behind in both.
Take the Floor presents a note as slides, with your speaker notes on your own screen. It reads a note the same way Due Credit does, with the same code, so Insert citation writes the links it shows as citations.
Give both plugins the same Bibliography and Citation style. Your chapter and your talk then cite the same way.
Due Credit runs entirely on your computer, and doesn't send anything of yours
anywhere. It connects to the internet for one thing only. When you have no
pandoc installed and agree to download the built-in one, it gets
pandoc-3.13-wasm.zip from pandoc's release on GitHub. Before keeping it, Due
Credit checks that the download is exactly the file it was tested with, by
comparing its SHA-256 hash, a fingerprint of the file's contents.
.bib file you set in Bibliography, when you
export and when you insert a citation, and any --bibliography in Pandoc
arguments when you export.~/Zotero/styles), or the
.csl file you set..docx you set, if any.app.json.pandoc-3.13.wasm in your cache folder, when
there's no pandoc installed. Once a session, Due Credit checks its hash to
make sure the file hasn't changed. A file that doesn't match is deleted, and
downloaded again if you agree.Due Credit only writes in a note when you ask it to add or change a citation at the cursor. It never writes anywhere else in your vault.
pandoc-3.13.wasm
in your user cache folder, outside the vault. The 17 MB download unpacks to
this 62 MB file. It goes in ~/.cache/obsidian-citation-core on Linux (or
in $XDG_CACHE_HOME), ~/Library/Caches/obsidian-citation-core on macOS,
and obsidian-citation-core\Cache in %LOCALAPPDATA% on Windows. If you
also use In the Open, it uses the same file. You can
delete it. It's downloaded again, if you agree, the next time it's needed.data.json in the plugin folder, including the folder
your last export went to.pandoc --version). An installed pandoc can read and write anything you
can.Nothing else runs.
When your note shows an image from the web, like ,
an installed pandoc downloads it to put it in the file. That's how pandoc
works, and it only happens for images on the web. The built-in pandoc can't
download anything. It puts the image's description in its place, and says so.
Every change I push is built, checked with ESLint and the official Obsidian ESLint plugin, and tested with Vitest. Nix builds it a second time, on its own.
Releases are built by GitHub Actions from the tagged code, after the same
checks. A release only goes out when its tag matches the version in
manifest.json, and every action it uses is pinned to an exact version. Each
release comes with a signed attestation from GitHub, which records what it
was built from. To check that the main.js you installed is the one GitHub
built:
gh attestation verify main.js --repo jorritvanderheide/obsidian-due-credit
The citation tests run through a real pandoc, always the same version, in obsidian-citation-core, which holds the citation code. A release only uses a version of it that passed them, so a change in pandoc's output shows up as a failing test before it reaches you.
Have a look at the FAQ first. It covers the things people run into most, like a citation that comes out as plain text. If something still doesn't work, or you have an idea, please open an issue. Found a security problem? Please report it privately, the way the security policy explains.
The code lives on Codeberg, with a copy on GitHub.
Due Credit is free. If it's useful to you and you'd like to give something back, you can do that on Liberapay:
Copyright © 2026 Jorrit van der Heide. Licensed under the EUPL-1.2.
Open Sans, from fonts/ in obsidian-citation-core, is under the
SIL Open Font License 1.1.