Is it possible to add custom IDs to <figure> tags using the prebuilt-layout model with Markdown output?

Question

Hi everyone,

I'm using Azure Document Intelligence (prebuilt-layout model) in Python and generating Markdown output. Here's the relevant code:

poller = self.client.begin_analyze_document(
    "prebuilt-layout",
    AnalyzeDocumentRequest(bytes_source=file_content),
    output_content_format=DocumentContentFormat.MARKDOWN,
    output=[AnalyzeOutputOption.FIGURES],
)

The generated Markdown includes <figure> tags, but they come without any attributes:

<figure>
...
</figure>

I also have access to the full JSON result, where each figure has an id like "1.1".

Question: Is there a way (via parameters or options in the API) to include an id attribute directly in the <figure> tags in the Markdown output — for example, <figure id="1.1">...</figure>?

Or is manual post-processing the only way to achieve this?

Thanks in advance!

Answer 1

Hi Nelson Guamán

Currently, the Azure Document Intelligence prebuilt-layout model does not support adding custom id attributes directly to <figure> tags in the Markdown output through any API parameters or options. While the JSON result includes figure IDs (like "1.1"), these IDs are not automatically added to the Markdown. So, the only way to include them is through manual post-processing—after getting the Markdown output, you would need to write a script to go through each <figure> tag and add the corresponding ID from the JSON result.

It’s very likely that Azure will include this feature in a future update to make the Markdown output more customizable and semantically rich.

I hope this information helps. Thank you!