Markdown Footnotes & Citations to Word: Academic Reference Guide

Numbered Footnotes

The most common footnote syntax uses a caret and bracket notation. You place the marker in your text where the reference should appear, and then define the footnote content elsewhere in the document (typically at the bottom). The footnote label can be any alphanumeric string—Pandoc will automatically renumber them sequentially in the output.

This claim requires a source.[^1] Another point worth noting.[^2]

[^1]: Smith, J. (2024). *Introduction to Academic Writing*. Oxford University Press, p. 42.
[^2]: Doe, A. & Lee, B. (2023). "Citation practices in the humanities."
    *Journal of Scholarly Communication*, 15(3), 112-128.

When converted to Word, each [^1] marker becomes a superscript number, and the footnote text appears at the bottom of the page. Pandoc handles the numbering automatically, so you can use descriptive labels like [^smith2024] instead of plain numbers to keep your source readable.

Inline Footnotes

Pandoc also supports inline footnotes, where the footnote content is written directly at the point of reference. This is convenient for short notes but can make the source text harder to read for longer annotations.

This is a statement with an inline footnote.^[See Johnson (2025) for a detailed analysis
of this phenomenon, particularly chapters 3 and 7.]

The next paragraph continues normally after the inline note.

Inline footnotes are ideal for brief parenthetical comments or short source attributions. For longer explanatory notes or full bibliographic entries, numbered footnotes keep your Markdown source cleaner and easier to maintain.

Multi-Paragraph Footnotes

Sometimes a footnote needs to span multiple paragraphs—for example, when providing extended commentary or quoting a source at length. Pandoc supports this by indenting subsequent paragraphs within the footnote definition with four spaces.

[^longnote]: This is the first paragraph of a long footnote.

    This is the second paragraph, indented with four spaces.
    It continues the same footnote.

    > You can even include block quotes inside footnotes.

    And a third paragraph to wrap things up. All of this content
    will appear as a single footnote in the Word output.

Multi-paragraph footnotes are rendered correctly in Word, preserving paragraph breaks and any nested formatting such as block quotes, lists, or emphasis. This makes Markdown footnotes surprisingly powerful for academic annotation, where lengthy explanatory notes are common in fields like history, law, and literary studies.

Creating a .bib File

Each BibTeX entry starts with an entry type (prefixed with @), followed by a unique citation key in curly braces. The key is what you will use in your Markdown to reference the source. Here is a complete example showing the most common entry types:

@article{smith2024writing,
  author    = {Smith, John and Doe, Jane},
  title     = {Modern Academic Writing Practices in the Digital Age},
  journal   = {Journal of Scholarly Communication},
  year      = {2024},
  volume    = {18},
  number    = {2},
  pages     = {45--67},
  doi       = {10.1234/jsc.2024.0042},
  publisher = {Academic Press}
}

@book{johnson2023research,
  author    = {Johnson, Maria},
  title     = {Research Methods for the Social Sciences},
  edition   = {4th},
  year      = {2023},
  publisher = {Cambridge University Press},
  address   = {Cambridge, UK},
  isbn      = {978-1-108-12345-6}
}

@inproceedings{lee2025machine,
  author    = {Lee, Wei and Chen, Xiao and Park, Soo-Jin},
  title     = {Machine Learning Approaches to Citation Analysis},
  booktitle = {Proceedings of the 12th International Conference on
               Computational Linguistics},
  year      = {2025},
  pages     = {234--241},
  address   = {Tokyo, Japan},
  doi       = {10.5678/iccl.2025.0034}
}

@online{pandoc2026manual,
  author  = {MacFarlane, John},
  title   = {Pandoc User's Guide},
  year    = {2026},
  url     = {https://pandoc.org/MANUAL.html},
  urldate = {2026-03-15}
}

Common Entry Types

BibTeX supports dozens of entry types, but the following cover the vast majority of academic sources:

Citing Sources in Markdown

Once your .bib file is ready, you reference entries in your Markdown using the @ symbol followed by the citation key. Pandoc supports several citation formats:

# Citation Syntax Examples

## Parenthetical citation (author and year in parentheses)
Studies have shown significant improvement [@smith2024writing].

## Narrative citation (author in text, year in parentheses)
@johnson2023research argues that mixed methods produce stronger results.

## Multiple sources in one citation
This has been confirmed by several researchers [@smith2024writing;
@lee2025machine; @johnson2023research].

## Citation with page number
The framework was first described in detail [@smith2024writing, pp. 52-58].

## Suppress author name (year only)
Smith [-@smith2024writing] later revised this position.

## Citation with prefix and suffix
[see @johnson2023research, chapter 4, for a thorough discussion]

Each of these citation forms will be rendered differently depending on the CSL style you choose. In APA, a parenthetical citation becomes (Smith & Doe, 2024), while in Chicago author-date it becomes (Smith and Doe 2024). The same Markdown source produces correct output for any style—you just swap the CSL file.

Downloading CSL Files

The official CSL repository at github.com/citation-style-language/styles contains thousands of free style definitions. You can also browse and search at zotero.org/styles. Download the .csl file for your required style and place it in your project directory.

Common CSL files you might need:

• apa.csl — APA 7th Edition (author-date)
• modern-language-association.csl — MLA 9th Edition
• chicago-fullnote-bibliography.csl — Chicago Notes & Bibliography
• chicago-author-date.csl — Chicago Author-Date
• ieee.csl — IEEE (numbered citations, common in engineering)
• vancouver.csl — Vancouver (numbered citations, common in medicine)
• harvard-cite-them-right.csl — Harvard referencing

YAML Front Matter Configuration

The cleanest way to configure Pandoc's citation processing is through YAML front matter at the top of your Markdown file. This eliminates the need for long command-line flags and makes your configuration version-controlled alongside your document.

---
title: "The Impact of Digital Tools on Academic Writing"
author: "Jane Doe"
date: "2026-03-19"
bibliography: references.bib
csl: apa.csl
link-citations: true
reference-section-title: "References"
lang: en-US
---

# Introduction

The rise of digital writing tools has transformed academic
publishing [@smith2024writing]. Researchers now have access to
sophisticated reference management systems that integrate
directly with their writing workflow [@johnson2023research,
chapter 2].

# Literature Review

Recent studies in computational linguistics have demonstrated
the potential of machine learning for citation analysis
[@lee2025machine]. As noted by @johnson2023research, mixed
methods approaches yield the most reliable results.

# References

Key YAML fields for citation processing:

• bibliography — Path to your .bib file (or multiple files as a YAML list)
• csl — Path to your CSL style file
• link-citations: true — Makes in-text citations clickable links to the bibliography entry
• reference-section-title — Heading text for the auto-generated bibliography
• nocite — Include sources in the bibliography that are not cited in the text (use nocite: '@*' for all entries)
• suppress-bibliography — Set to true if you want citations but no bibliography (rare)

Complete Command Examples

With the YAML front matter in place, the conversion command is simple. Without YAML, you pass the options as flags.

Basic conversion (YAML configured):

pandoc paper.md --citeproc -o paper.docx

Full command-line flags (no YAML):

pandoc paper.md \
  --citeproc \
  --bibliography=references.bib \
  --csl=apa.csl \
  --metadata link-citations=true \
  --metadata reference-section-title="References" \
  -o paper.docx

With a custom Word template:

pandoc paper.md \
  --citeproc \
  --bibliography=references.bib \
  --csl=chicago-fullnote-bibliography.csl \
  --reference-doc=my-template.docx \
  -o paper.docx

Multiple bibliography files:

pandoc paper.md \
  --citeproc \
  --bibliography=primary-sources.bib \
  --bibliography=secondary-sources.bib \
  --csl=modern-language-association.csl \
  -o paper.docx