Using Docling CLI to produce markdown, is it possible to include page breaks?

[njlr]

Using the Docling CLI to produce markdown, is it possible to include page breaks?

Since there is no standard for page breaks in markdown, can it be configured?

[dosubot[bot]]

Hi @njlr! I'm Dosu and I’m helping the docling team.

The Docling CLI doesn't currently expose a page break option for markdown export. However, the Python API supports this via the page_break_placeholder parameter:

from docling import DocumentConverter

converter = DocumentConverter()
result = converter.convert("your_document.pdf")
doc = result.document

# Export with custom page break delimiter
md = doc.export_to_markdown(page_break_placeholder="\n\n---\n\n")

You can use any string you want as the placeholder (e.g., <!-- pagebreak -->, ---, or HTML-style <div style="page-break-after: always;"></div>).

If CLI support for this option would be useful, it might be worth opening a feature request to add a --page-break-placeholder flag.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}