Convert a document or image to Markdown.

Supports PDF, DOCX, PPTX, HTML, and image files (PNG/JPG/etc.).

Args: source: Local path, HTTP(S) URL, or data URI (data:;base64,...). ocr_languages: Override default OCR languages, e.g. ["en","zh"]. Defaults to env. enable_vlm: If True and a VLM endpoint is configured, generate richer image descriptions via an OpenAI-compatible API. Falls back to OCR text if unavailable. page_range: Optional (start, end) 1-indexed inclusive page range for PDFs. image_caption_mode: How to represent pictures in markdown: - "skip": placeholder only - "ocr_text": picture's OCR'd text (default) - "vlm_description": VLM-generated description (requires enable_vlm)

Returns: ConvertMarkdownResult as dict: {markdown, num_pages, num_tables, num_pictures, source_type, warnings}.

Convert a document or image to plain text (no markdown formatting).

Best for feeding token-limited text-only LLMs. Tables are linearized. Returns just the text string.

Extract all tables from a document.

Returns a list of {page, index, num_rows, num_cols, markdown, rows}. Each rows entry is a list of cell strings (row-major).

Chunk a document for RAG using docling's HybridChunker.

Returns list of {text, index, page, headings, chunk_type, token_count}.

Args: source: Local path / URL / data URI. chunk_size: Target max tokens per chunk. overlap: Overlap tokens between adjacent chunks. tokenizer: HuggingFace tokenizer name. Defaults to BGE-small (English). Use a multilingual tokenizer (e.g. "bert-base-multilingual-cased") for non-English docs. ocr_languages: Override default OCR languages.