Docling: lesson test 2026-10-11 (passed)

Record test:zcpidpi. Question: Convert one owner-chosen local PDF and inspect the output.

Answer

On 2026-10-11, the headlesson operator ran all 3 steps of this lesson with Docling 2.137.0 (macOS26.5.2 arm64; Python3.11.13 disposable venv; wheel-only PyPI installation; no LLM use), and all passed. The final Next step is advice and was not run. An independent check (revision 3fadc9d) covered: Independent trial and audit on one self-made English page: headings, text and a table compared with the Markdown output; the source PDF was rendered independently. Its limits: Sample-limited. Scanned images, Japanese OCR and complex real documents were not measured. This is the operator's own run, not a vendor claim.

Tested on

• Test date: 2026-10-11
• Record confirmed: 2026-10-11
• Version: 2.137.0
• Environment: macOS26.5.2 arm64; Python3.11.13 disposable venv; wheel-only PyPI installation; no LLM use
• Sample tested: one born-digital English page (self-made)
• Result: passed, 3/3 steps

Lesson steps and what happened

• 1. [passed] pip install docling
• 2. [passed] docling ./sample.pdf
• 3. [passed] Inspect the generated Markdown in the current directory against the original PDF.

Next (advice, not tested)

Next: Select the real document and output destination with the user, run docling <confirmed-document-path>, then compare text, tables and reading order with the original. Record missing or misread content before sending the output to a downstream LLM.

Cautions recorded with the lesson

These notes come from the lesson. Some describe failures seen in tests; others are general cautions. Each one is not a separately tested result.

• Python 3.10 or newer and an owner-provided sample.pdf are prerequisites; first use may download model assets.
• Software MIT licensing does not determine every model component or weight license.
• Japanese OCR support is backend/version dependent and is not an accuracy guarantee.
• Successful conversion or schema validation does not prove source-faithful transcription.
• Confirm: Check formats/languages, model assets, output path and permission/costs for any downstream external transfer; a successful conversion is not an accuracy guarantee.

What this record does not show

• Not measured in this run: scanned pages and Japanese OCR.
• Not measured in this run: multi-page documents and complex math.
• Not measured in this run: downstream LLM accuracy.
• Not measured in this run: the code license versus model-weight terms.
• Whether an agent new to this tool can use it from this record alone (the operator wrote and ran the lesson).
• Comparisons between models or clients.
• Production use, accounts, or real customer data.
• Behaviour of the latest version (the test is tied to the version and date below).
• The final "Next" step is advice and was not part of the test.

Primary record

Operator record: a past lesson trial (legacy). It is not claimed to meet level L1 of run-task-contract/0.1.0.

Independent check

Independent check (revision 3fadc9d6215b): Independent trial and audit on one self-made English page: headings, text and a table compared with the Markdown output; the source PDF was rendered independently.

Limits: Sample-limited. Scanned images, Japanese OCR and complex real documents were not measured.

Evidence

A non-public test report exists and is not published, so third parties cannot check it directly.

Retrieve over MCP

headlesson_get id="app:docling" sections ["lesson","gotchas"] on https://mcp.headlesson.com/mcp

Source version

This page is built from the catalog record app:docling at revision bc56389411af. It is not rewritten when the current lesson changes; a new test gets a new record ID.

Sources (lesson text at the fixed revision)

Each line names fields of this page (as JSON pointers into the .json version) and where they come from. Labels without a link are non-public sources. Fields not listed (such as test results) are the headlesson operator's own observations.

• /question, /steps/2/step, /cautions/items/0, /cautions/items/3: headlesson editorial judgement (checked 2026-10-09, inferred, editorial)
• /steps/0/step, /steps/1/step: https://github.com/docling-project/docling/blob/main/README.md (checked 2026-10-09, primary, editorial)
• /next_advice, /cautions/items/4: https://raw.githubusercontent.com/docling-project/docling/main/README.md (checked 2026-10-10, inferred, editorial)
• /cautions/items/1: https://github.com/docling-project/docling/blob/main/README.md (checked 2026-10-09, primary, official)
• /cautions/items/2: https://docling-project.github.io/docling/concepts/OCR/ (checked 2026-10-09, primary, official)

Corrections

None.

Cite

headlesson test:zcpidpi (app:docling): On 2026-10-11, the headlesson operator ran all 3 steps of this lesson with Docling 2.137.0 (macOS26.5.2 arm64; Python3.11.13 disposable venv; wheel-only PyPI installation; no LLM use), and all passed. The final Next step is advice and was not run. An independent check (revision 3fadc9d) covered: Independent trial and audit on one self-made English page: headings, text and a table compared with the Markdown output; the source PDF was rendered independently. Its limits: Sample-limited. Scanned images, Japanese OCR and complex real documents were not measured. This is the operator's own run, not a vendor claim. https://headlesson.com/tests/zcpidpi

Page updated: 2026-10-13 (the date its content last changed).

要約（日本語）: Docling の lesson を 2026-10-11 に headlesson の運営が 2.137.0 で試し、3/3 段が通った（passed、運営の実測で製品側の主張ではない）。この記録が示さないこと・独立確認の状況は本文のとおり。