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.
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
We sent the complete four-page PDF in one request to Nutrient's Build API, asking for Markdown output with no processing actions.
Returned Markdown: the caption in place and no image anywhere in the file
Copied from Output file (Markdown), lines 80–88
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
Recorded API exchange: the Markdown request and a response with no image files
Copied from Captured file (JSON), response
{ "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 }
| ✗ | 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. |
- 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 }
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.
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.
How this scenario is graded
How we decide Pass, Fail and Not gradable. The same rules apply to every tool tested on this scenario.
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.
- 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.
| Level | Name | Scope |
|---|---|---|
| Benchmark | Converting a complex PDF into clean Markdown with a hosted API → | 12 scenarios · 13 tools |
| Capability | Figures & Charts → | |
| Scenario | A document with figures and captions → | |
| Tool | Nutrient.io → |
Global scenario definition → · Global capability definition → · Nutrient.io product page →
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.
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.
You run the same kind of test against your own setup and get the same behaviour.
Agree →Yours behaves differently. Tell us what you got, with a screenshot if you have one.
Disagree →Something here is wrong — a reference value, a transcription, a grade.
Report an issue →Tell us what changed and we schedule a rerun of the failing test case. The old result stays as history.
Vendor notice →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.
File fingerprints (SHA-256)
A fingerprint identifies the exact file used for this result.