MarkdownSettings

Settings for Markdown. Values fall back through three levels: document → SDK → built-in default. Writes target the document only when set on a document’s settings, otherwise the SDK globally when set on SdkSettings.

Tags: Format

from nutrient_sdk import MarkdownSettings

Construction

# Per-document override
with Document.open("input.pdf") as doc:
    settings = doc.settings.markdown_settings
    settings.some_field = new_value          # mutate fields directly

# SDK-wide default (applies to all documents)
SdkSettings.markdown_settings.some_field = new_value

Settings are configured by writing to fields on the returned object. The settings property itself cannot be reassigned — doc.settings.markdown_settings = other_settings is rejected.

Properties

enable_inline_formatting

@property
def enable_inline_formatting(self) -> bool

@enable_inline_formatting.setter
def enable_inline_formatting(self, value: bool) -> None

Controls whether inline text formatting (bold, italic) is preserved in the Markdown output using standard markers (bold, italic).

Type: bool

Default: false

enable_semantic_block_formatting

@property
def enable_semantic_block_formatting(self) -> bool

@enable_semantic_block_formatting.setter
def enable_semantic_block_formatting(self, value: bool) -> None

Controls whether footnotes and captions are rendered with semantic Markdown markers (> , …) and whether pictures are emitted at all (![alt] / [Figure]). When , footnotes and captions render as plain paragraphs and pictures are dropped entirely. List items always render with - regardless.

Type: bool

Default: true

image_export

@property
def image_export(self) -> ImageExportMode

@image_export.setter
def image_export(self, value: ImageExportMode) -> None

Controls how images are exported when converting documents to Markdown.

Type: ImageExportMode

Default: ImageExportMode.None

include_headers_and_footers

@property
def include_headers_and_footers(self) -> bool

@include_headers_and_footers.setter
def include_headers_and_footers(self, value: bool) -> None

Controls whether running headers and footers are included in the Markdown output. When included, they render as plain text paragraphs.

Type: bool

Default: false