Struct DoclingDocument 

pub struct DoclingDocument {
    pub name: String,
    pub nodes: Vec<Node>,
    pub strict_markdown: bool,
}

The unified, format-agnostic document produced by every backend.

This is the heart of docling: backends parse their source format into a DoclingDocument, and serializers turn it back into Markdown, HTML, JSON, etc. Phase 0 uses a flat sequence of Nodes; the production schema will match docling-core’s body-tree-with-references layout.

Fields

name: String

Logical document name (usually the input file stem).

nodes: Vec<Node>

Top-level content, in reading order.

strict_markdown: bool

Default Markdown export mode for Self::export_to_markdown. false (the default) reproduces docling’s legacy output byte-for-byte; true emits cleaner, more conformant Markdown. Set by DocumentConverter.

Implementations

impl DoclingDocument

pub fn new(name: impl Into<String>) -> Self

Create an empty document with the given name.

pub fn push(&mut self, node: Node)

Append a node.

pub fn add_heading(&mut self, level: u8, text: impl Into<String>)

Convenience: append a heading.

pub fn add_paragraph(&mut self, text: impl Into<String>)

Convenience: append a paragraph.

pub fn export_to_markdown(&self) -> String

Serialize the document to Markdown.

The Rust equivalent of docling-core’s DoclingDocument.export_to_markdown(). Uses Self::strict_markdown to pick between docling-legacy output (default) and the cleaner, more conformant variant.

pub fn export_to_markdown_with(&self, strict: bool) -> String

Serialize to Markdown, explicitly choosing the mode regardless of Self::strict_markdown. strict = true produces cleaner, more conformant Markdown (code-fence languages preserved, no inline-run spacing artifacts); strict = false reproduces docling’s legacy output.

pub fn export_to_json(&self) -> String

Serialize to docling-core’s native JSON wire format (DoclingDocument schema), pretty-printed — the Rust equivalent of DoclingDocument.export_to_dict() / save_as_json(). The output loads back into Python docling-core and round-trips to the same Markdown.

pub fn export_to_markdown_with_images( &self, image_mode: ImageMode, artifacts_dir: &str, ) -> (String, Vec<(String, Vec<u8>)>)

Serialize to Markdown with an explicit picture ImageMode (mirrors docling’s image_mode). Returns the Markdown and, for ImageMode::Referenced, the (relative-path, bytes) of each image the caller should write next to the Markdown file. artifacts_dir is the directory name used in referenced links.

Trait Implementations

impl Clone for DoclingDocument

fn clone(&self) -> DoclingDocument

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DoclingDocument

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for DoclingDocument

fn eq(&self, other: &DoclingDocument) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DoclingDocument