Due Credit

Due Credit

Export a note to Word, PDF or LaTeX through pandoc, with its links turned into real citations.

Works well with Paper Trail, which writes those links for you from your Zotero library. 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 the note you have open, turns your links into real citations with a reference list, in the citation style you choose, and leaves out everything that only makes sense in Obsidian, like your comments and tags.

1 Installation

1. Install pandoc from pandoc.org. Due Credit is tested with pandoc 3.7.
2. For PDF, install a TeX distribution that includes xelatex, such as TeX Live or MiKTeX. You can skip this if you only need Word, Markdown or LaTeX.
3. For citations, export a .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.
4. Install Due Credit in Obsidian: go to Settings → Community plugins → Browse, search for "Due Credit", then install and enable it. You can also open its page in the plugin directory.

Due Credit needs Obsidian 1.13 or later, on desktop.

2 Getting started

1. Point Due Credit at your bibliography. In Settings → Due Credit, set Bibliography to your .bib file. The default is Literature/library.bib in your vault, and a file outside the vault works too, starting with / or ~.
2. Cite something. In a note, write a link to a paper by its citation key: As [[marsh2024]] shows, ….
3. Export it. Run Export to Word, or right-click the note and choose it from the menu. Pick where to save it, and open the file: the link is now "(Marsh 2024)", and there's a reference list at the end.

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.

3 Safety and quality

Due Credit reads your notes and writes nothing in your vault. It only writes the file you pick in the save dialog, and 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 doesn't connect to the internet itself, and the only program it runs is pandoc.

The health report in Obsidian's plugin directory warns about two things, and both are how the export works. Shell Execution is pandoc: Due Credit starts it directly, without a shell in between, and starts nothing else. Direct Filesystem Access is for what the Obsidian API can't reach: reading your bibliography and citation style wherever you keep them, checking that the files in your settings exist, putting pandoc's filters, the PDF font and the note's properties in a temporary folder, and making sure an export doesn't land in your vault.

Every push is tested, and every release is built in the open with a signed attestation, so you can check that the file you installed is the one that was built. Section 11.5 says how.

Table of contents

• 4 Documentation
• 5 Features
• 6 How it works
• 7 Citations
• 8 Commands
• 9 Settings
• 10 Works well with
• 11 Network and file disclosure
• 12 Questions or issues?
• 13 Support
• 14 License

4 Documentation

If you want to work on the plugin, or use its pandoc filter on its own:

• Architecture - How the code is layered, how pandoc is run, and the order its filters run in.
• Pipeline - Every step from a note to pandoc's input, in order.
• Citations - Every link form that becomes a citation, footnote styles, LaTeX, and the agreement with Paper Trail.
• Settings - How settings are stored, and which pandoc arguments are refused and why.
• Development - Setup, tests, the conformance check, and releases.

5 Features

5.1 Exporting

• Four formats - Word, PDF, Markdown and LaTeX, from the command palette or a note's right-click menu.
• Without opening the note - Export any note from the file explorer or its tab.
• A PDF that looks good - Typeset with xelatex on A4, left-aligned, in Open Sans, which comes with the plugin.
• LaTeX for a journal - A body with \cite commands, ready for a journal's or conference's own class.

5.2 Citations

• Links become citations - [[marsh2024]] becomes "(Marsh 2024)", with a reference list at the end.
• Pages, prefixes and more - Everything pandoc can put in a citation, in the link's label.
• Any citation style - Any style Zotero has installed, such as apa, or a .csl file, including footnote styles.
• Paper notes under any name - A link to a note with a citekey property cites that key, even after Better BibTeX changed it.
• A check before you export - Links that are about to come out as plain text are listed first, so nothing goes wrong quietly.

5.3 Private stays private

• Comments stay behind - %%…%% and <!-- … --> never leave the vault.
• Only the properties that matter - Tags and the rest of your properties don't travel inside the file.
• No Obsidian leftovers - Block IDs, tags, embedded notes and plugin blocks are left out.

5.4 Your institution's rules

• Word template - Use your university's or journal's styles for fonts, headings and margins.
• Your own pandoc arguments - Add a table of contents, numbered sections, margins, a font, or a filter like pandoc-crossref.

6 How it works

6.1 What happens to your note

Before pandoc runs, Due Credit removes or rewrites everything that only makes sense inside Obsidian:

6.2 The reference list

The reference list is headed References, or Bibliography under a style that cites in footnotes. Set reference-section-title in the note's properties to call it something else, for a note in another language.

7 Citations

7.1 Writing a citation

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:

A link to one of your own notes isn't in the bibliography, so it exports as its words, not as a dead link. Pandoc's own [@marsh2024, p. 12] works too.

Don't put your own parentheses around a citation: the export adds them, so ([[marsh2024]]) would come out as "((Marsh 2024))".

7.2 Naming the author in your sentence

When your sentence already names the author, put a - against the key to leave the author out of the citation:

Under a style that cites in footnotes, this works a little differently. See Footnote styles.

7.3 Paper notes

A paper note doesn't have to be named after its key. A link to a note with a citekey property cites that key, so [[Marsh (2024) The Quiet Archive]] is (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.

7.4 Before the export

Before an export runs, Due Credit lists every link that's about to come out as plain text instead of a citation:

• A link to a paper note whose key isn't in your bibliography. Usually Better BibTeX changed the key, or its auto-export hasn't run since you added the paper.
• A link to no note at all, whose name isn't a key either. For example, a paper you cited before its auto-export ran, or a note you haven't written yet.

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.

8 Commands

None of the commands has a hotkey, so you can choose your own in Settings → Hotkeys. Each one 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.

• 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.

9 Settings

Pandoc

Citations

10 Works well with

These plugins are by the same author. Each does one thing, and Due Credit doesn't need the other, but they fit together nicely.

10.1 Paper Trail

Paper Trail turns your Zotero library into a reading queue, and writes citations as links: Insert citation picks a paper and writes [[citekey]], with a page if you want one. Everything it writes, Due Credit reads, including prefixes, pages and the - for leaving out the author. It also gives every paper note the citekey property that keeps your citations working when Better BibTeX changes a key.

Paper Trail helps you write the citations in your chapter, and Due Credit gets the chapter out of your vault.

11 Network and file disclosure

Due Credit runs entirely on your computer. It doesn't connect to the internet itself, and doesn't send anything anywhere.

11.1 What it reads

• Notes: The note you export, and the citation keys of the notes it links to.
• Bibliography: The .bib file you set in Bibliography.
• Citation style: From Zotero's styles folder (~/Zotero/styles), or the .csl file you set.
• Word template: The .docx you set, if any.
• Obsidian's settings: Whether strict line breaks are on, from the vault's app.json.

11.2 What it writes

Nothing in your notes, and nothing anywhere else in your vault.

• The export: Only the file you pick in the save dialog, never inside your vault.
• Temporary files: For each export, pandoc's filters, the PDF font and the note's properties go in a temporary folder, which is removed afterwards.

11.3 What it stores

• Settings: Its own data.json in the plugin folder, including the folder your last export went to.

11.4 What it runs

• Pandoc: The one you set in Pandoc, and for a PDF, xelatex through pandoc. Nothing else.

Pandoc itself downloads an image your note links to on the web, like ![](https://…/figure.png), to put it in the file. That's pandoc's own behaviour, and it only happens for images that are on the web.

11.5 How releases are built

Every push is built, linted with ESLint and the official Obsidian ESLint plugin, and tested with Vitest on Node 20, 22 and 24. The citation tests run through a real, pinned version of pandoc, so its output can't drift unnoticed. Releases are built by GitHub Actions from the tagged source, with every action pinned to an exact version, and come with a signed build provenance attestation, so you can check that the file you installed is the one that was built:

gh attestation verify main.js --repo jorritvanderheide/obsidian-due-credit

12 Questions or issues?

Have a look at the FAQ first: it covers the most common surprises, 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, as described in the security policy.

The source lives on Codeberg and is mirrored to GitHub.

13 Support

Due Credit is free. If you find it useful, you can support its development on Liberapay:

14 License

Copyright © 2026 Jorrit van der Heide. Licensed under the EUPL-1.2. Open Sans, in fonts/, is under the SIL Open Font License 1.1.