AI Demos Research — the structured-intelligence platform. Every verdict on these pages opens to the execution behind it.
Graded 22 October 2026

Does MarkItDown keep footnotes separate from body text and tied to their references?

MarkItDown kept all 13 footnotes separate from the body text and associated with their in-text references. The notes followed their pages’ body text, with all 13 reference numbers preserved.

1 of 1 test case passed

Every test case in this scenario has a result.

Pass rate100%1 of 1 gradable
Coverage1 of 1test case with a result
1PassDid everything it was expected to do.
0FailNo test case failed.
0Not gradableEvery result here could be graded.
0UntestedEvery test case in this scenario has a result.
The pass rate is a summary. The evidence is the test case below: what we sent, what we checked, what the tool returned, and the proof.

The test case

Each test case is judged on its own: Pass, Fail, Not gradable, or Untested. The scenario result above is based on this test case.

Footnote — out of body flow, associatedPassEvidence
What we sent

In the terminal, we ran the Python conversion command on the PDF offprint about the Braithe Order.

InputDocument (PDF)
Input PDF: page-bottom footnotes and their superscript references in the body text
Open the PDF ↗
What the tool returned
Markdown
1 Braithe Estuary Order 1974, art. 6(2). The Order is reproduced in full in the appendix to R. Sandiman, The Braithe Estuary:

A Documentary History (Vardenne, 1988), 211-24.

2 Minutes of the Harbour Board, 14 May 1973 (Braithe Record Office, BHB/3/17), 4.
3 The point was not argued in Tarbert v Braithe Harbour Board [1981] 2 EstLR 88, where both parties proceeded on the

assumption that art. 6(2) applied.

4 The Board's file on the 2011 consents (Braithe Record Office, BHB/11/4) contains three letters returned undelivered and a

note of a telephone call to a solicitor in Winnipeg.

Returned Markdown: numbered footnotes grouped after each page’s body text

Copied from Output file (Markdown), lines 48–59

Open the Markdown file ↗
Markdown
5 Report of the Committee on Estuarine Consents (Cmnd 6712, 1977), paras 88-94.
6 See further A. Prosser, 'Consent and its conditions' (1994) 12 EPR 3, 9-14, whose account of the 1977 committee differs

from mine at one point of substance.

7 The Harbour Board series appears to have been reconstructed in 1981, probably for the purposes of the Tarbert litigation.

Copied from Output file (Markdown), lines 113–118

Markdown
8 Braithe Record Office, BHB/3/14-24. The marked-up print is BHB/3/22.
9 Notably Prosser, 'Consent and its conditions', 7, who calls the deletion 'tidying'.
10 Minutes of the fourth meeting, 9 July 1973 (Braithe Record Office, BHB/3/19), 2-6.

Copied from Output file (Markdown), lines 145–147

Markdown
11 Braithe Estuary Order 1974, art. 6(3). The threshold is discussed at the fourth meeting, ibid., 5.
12 Braithe Record Office, BHB/3/22, fo. 4.
13 I am grateful to the departmental records officer for a search, and for the confirmation that the file was weeded in 1998.

Copied from Output file (Markdown), lines 172–174

Expected vs. Found
✓Expected: Keep each footnote separate from the body text, present in the Markdown and associated with its in-text reference.Found: All 13 source footnotes remained after their page’s body text, outside body paragraphs; all 13 in-text references remained, preserving the numbered associations.
Supporting proof
Proof 1Screenshot
Terminal capture: the conversion command and successful completion
Open original ↗
Why this result

The footnotes had to stay present, outside body paragraphs and associated with their references. They did; the formatting defects neither removed a note nor detached it from its reference.

Also observed in this test case

Plain digits replace superscripts. All in-text footnote markers became plain digits, distinguishable from ordinary text by position alone. Marker 9 on the third page was also separated from its sentence by a space.

Split footnote paragraphs. Blank lines split footnotes 1, 3, 4 and 6, leaving each continuation as a separate paragraph.

Tested by Vamshidhar Rao Thumula · evidence dated 22 October 2026

Configuration and setup

How this tool was set up for the run and what the test needed in place. Each row is a fact from the run's records; a fact the records do not hold is left out, not guessed.

Software that produced the output
MarkItDown
Build or version
0.1.7
Surface
SDK / library
Set up before the run
The PDF offprint about the Braithe Order needed body references to page-bottom footnotes. Conversion had to include the whole document, using the default pipeline in one pass without flag tuning.
Tested
22 October 2026 · Vamshidhar Rao Thumula

How this scenario is graded

How we decide Pass, Fail and Not gradable. The same rules apply to every tool tested on this scenario.

How results are decided

Each test case gets one result per tool: Pass, Fail or Not gradable. A test case we haven't run yet shows Untested. There are no partial results.

The rules
  • Pass: the tool did everything the test expected, and nothing it said contradicts the correct answer.
  • Fail: at least one expected behaviour clearly didn't happen; the test case's result says which one and quotes the tool.
  • Not gradable: our evidence couldn't settle the outcome (for example a record we needed is missing). It is never counted as a fail, and the test case's result says what's missing.

Where this sits in the benchmark

This page is one cell of a larger study: one tool, one scenario. Only this benchmark's frame appears here.

History of this result

What has happened to this result since it was first published. Runs and grades are never overwritten: a retest or a re-grade publishes a new result and keeps the earlier one readable.

from the publication record
12 November 2026First publishedConverting a complex PDF into clean Markdown with an open-source library v1

Act on this result

Nothing filed here edits the run or the grade. A challenge opens a review, and a review can produce a new run or a re-grade — which becomes the current result and leaves this one in the history.

This matches what I see

You run the same kind of test against your own setup and get the same behaviour.

Agree →
This does not match

Yours behaves differently. Tell us what you got, with a screenshot if you have one.

Disagree →
Point out an issue

Something here is wrong — a reference value, a transcription, a grade.

Report an issue →
Request a retest

On a newer build, a larger dataset, or your own setup.

Request a retest →
We have fixed this

Tell us what changed and we schedule a rerun of the failing test case. The old result stays as history.

Vendor notice →
Filed against this evidenceNothing yet. Challenges, counter-evidence and fix notices appear here with their outcome, and stay on the page after they are resolved.
Cite this result
aidemos.com/benchmarks/pdf-to-markdown-open-source/results/markitdown/footnotes-at-the-bottom-of-the-page · 1 pass · 0 fail · coverage 1/1 · graded 2026-10-22

The same record is available as structured data through the AI Demos MCP server, with the counts, the coverage and every per-test-case reason carried as fields.

Verify the proof files

These files support this result. Open a file to inspect the original evidence.

Input · Document (PDF) ↗application/pdf · 152 KB
Output file (Markdown) ↗text/markdown; charset=utf-8 · 11 KB
Proof 1 · Screenshot ↗image/png · 72 KB
File fingerprints (SHA-256)

A fingerprint identifies the exact file used for this result.

Input · Document (PDF)fce3c87776b6f1b8f34dcfb0f6a274b5954edcb3d33ff7ee84840dfe2afbc1ad
Output file (Markdown)9a441b4cf3937f611d0234fe70d1fad1813c87075c831b78164d03ab720990c8
Proof 1 · Screenshot3b6beb5767c08a7dd1d4fb1b5459621f2811d6b54e70349a2b3e27d277b4bfae