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

Does Nutrient.io preserve figures and their captions in Markdown?

Nutrient.io's default Markdown conversion kept the figure's caption word for word and in its place, but dropped the figure itself: the returned Markdown has no image, link or placeholder where the survey-transect plan stood, and no image file came back with it.

1 of 1 test case failed

Every test case in this scenario has a result.

Pass rate0%0 of 1 gradable
Coverage1 of 1test case with a result
0PassNo test case passed.
1FailMissed at least one thing it was expected to do; the reason and proof are with each test case below.
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.

Figure with caption — preserved in placeFailEvidence
What we sent

We sent the complete four-page PDF in one request to Nutrient's Build API, asking for Markdown output with no processing actions.

InputDocument (PDF)
Input PDF: the four-page survey report, with the transect plan and its caption on page 2
Open the PDF ↗
What the tool returned

Returned Markdown: the caption in place and no image anywhere in the file

Copied from Output file (Markdown), lines 80–88

Markdown
rather than taken from photography, and because it is the line against which the advisers have asked that
marsh extent be reported.


Figure 1. Survey transects at Kellow Sands and Thrimby Point. Sampling stations are shown as filled circles and the 1998 saltmarsh
edge as a broken line.


Transect four crosses the toe of the training wall and has always behaved differently from the other three. It
Open the Markdown file ↗

Recorded API exchange: the Markdown request and a response with no image files

Copied from Captured file (JSON), response

JSON
{
  "status_code": 200,
  "headers": {
    "date": "Wed, 09 Sep 2026 08:52:24 GMT",
    "content-type": "text/markdown",
    "content-length": "5757",
    "content-disposition": "attachment; filename=\"result.md\"",
    "server": "Cowboy",
    "x-pspdfkit-remaining-credits": "43",
    "x-pspdfkit-request-cost": "1",
    "x-request-id": "GNObB39kjPIIvBQAAHwx"
  },
  "content_type": "text/markdown",
  "body_bytes": 5757,
  "delivery": "raw markdown body (content-type text/markdown)",
  "markdown_chars": 5755,
  "zip_members": null,
  "asset_names": null
}
Open the whole JSON file ↗
Expected vs. Found
✗Expected: The figure's image is kept, embedded or referenced, at its position in the Markdown, with its caption.Found: The caption 'Figure 1. Survey transects at Kellow Sands and Thrimby Point...' is there, between the same two paragraphs as in the source. The image is not: no image, link or placeholder, and no image file returned.
Supporting proof
Proof 1Screenshot
Side-by-side comparison: source page 2 with its figure beside the returned Markdown
Open original ↗
Proof 2Screenshot
Run card: the file sent, the free tier, the default pipeline and no saved assets
Open original ↗
Cited values1 value from this file
request
{ "method": "POST", "url": "https://api.nutrient.io/build", "multipart_fields": ["instructions", "file"], "instructions": { "parts": [ { "file": "file" } ], "output": { "type": "markdown" } }, "input_file": "intertidal_survey_BEP-SR-2026-11.pdf", "input_bytes": 308601 }
Why this result

The test needs both the image and its caption at the figure's position. The caption survived, but the image was lost in the conversion although the source page carries it, so it is a Fail. The result covers the default conversion only, on the page with the figure.

Tested by Chandresh Bisht · evidence dated 9 September 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
Nutrient.io
Build or version
Not exposed by the hosted product
Plan or tier
free tier
Surface
API
Set up before the run
A PDF with a figure and caption in normal text was converted to Markdown in one default-pass run, using the complete PDF rather than a cropped page.
Output format
Markdown
Processing actions
none (no OCR or image action requested)
Pipeline
Build API default pipeline
Tested
9 September 2026 · Chandresh Bisht

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
19 November 2026First publishedConverting a complex PDF into clean Markdown with a hosted API 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-apis/results/nutrient-io/a-document-with-figures-and-captions · 0 pass · 1 fail · coverage 1/1 · graded 2026-10-18

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 · 301 KB
Output file (Markdown) ↗text/markdown · 6 KB
Proof 1 · Screenshot ↗image/png · 171 KB
Captured file (JSON) ↗application/json · 1 KB
Proof 2 · Screenshot ↗image/png · 91 KB
File fingerprints (SHA-256)

A fingerprint identifies the exact file used for this result.

Input · Document (PDF)75b2bcc613580942d7d3222254c0f0d084525c2c6521f55cffa629c49f64c608
Output file (Markdown)f4798cb6749fb2adfa19f7f11dc8559353ef188dab3409cf4bfa00c5b2a9f800
Proof 1 · Screenshot8ed4389e5b6edc932cf42fbd4102165e4e03cf8f1b9d78e83614af30ff0bf553
Captured file (JSON)7fd4c70a1424e073a7227db70f158262849fde8166a3dedef454f26e59c5d156
Proof 2 · Screenshota221947c35d6ad3b24088c54846547f9d9e0ac7e995ea0577bbfd8ea6ebb120e