> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landing.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Markdown Response

export const adePythonLibrary = 'ade-python';

export const dpt2 = 'DPT-2';

export const dpt1 = 'DPT-1';

export const dpt = 'Document Pre-Trained Transformer';

export const companyName = 'LandingAI';

export const extract = 'ADE Extract';

export const parse = 'ADE Parse';

export const ade = 'Agentic Document Extraction';

When you call the [{parse} API](https://docs.landing.ai/api-reference/tools/ade-parse) endpoint ([https://api.va.landing.ai/v1/ade/parse](https://api.va.landing.ai/v1/ade/parse)), the API response includes `markdown` fields at three levels:

* **Top-level `markdown` field**: Contains the complete parsed document content as Markdown
* **Chunk-level `markdown` fields**: Each object in the `chunks` array includes its own `markdown` field containing only the content for that specific chunk
* **Split-level `markdown` fields**: Each object in the `splits` array includes a `markdown` field containing the content for that specific section of the document

All `markdown` fields use the same formatting and include embedded [HTML anchor tags](#anchor-tags) that link the content to specific chunks in the `chunks` array. These anchors enable you to trace content back to its location in the original document.

### Markdown Fields in Context

To better understand how these `markdown` fields work together, let's look at the parsing response for this pallet label:

<img src="https://mintcdn.com/landingaitest/KCUrPzqZHmNrwo6p/images/pallet-label.png?fit=max&auto=format&n=KCUrPzqZHmNrwo6p&q=85&s=399ff5fa389214f21abaca5d062ce526" alt="Pallet Label" width="400" data-path="images/pallet-label.png" />

Below is the full parsing response for this document with the `markdown` fields highlighted. Notice that each chunk's HTML anchor tag (the `<a id='...'>` element) appears consistently across all `markdown` fields.

This consistency means you can reference any chunk by its ID, whether you're working with the complete document Markdown, a specific split, or an individual chunk.

```json Markdown Fields {2,5,19,33,47,68} [expandable] theme={null}
{
  "markdown": "<a id='69a645fe-8617-4be8-b66f-68d7788755c0'></a>\n\nSKU\nWH-2847-BLK\n\n<a id='bdaf2198-0fdc-4c94-be54-a49ca796ea0f'></a>\n\nQUANTITY\n\n48 Units\n\n<a id='65fe085e-b8c8-46e0-848c-f0c32ccf16e8'></a>\n\n<::scan_code: Barcode\n\nThis is a clear, well-defined linear barcode with distinct black bars on a white background, showing no visible quality issues.::>\n\n<a id='9e551c40-3eaa-4d77-a219-50b7f4a57e05'></a>\n\n2847 0000 4812\n---\n",
  "chunks": [
    {
      "markdown": "<a id='69a645fe-8617-4be8-b66f-68d7788755c0'></a>\n\nSKU\nWH-2847-BLK",
      "type": "text",
      "id": "69a645fe-8617-4be8-b66f-68d7788755c0",
      "grounding": {
        "box": {
          "left": 0.06628379225730896,
          "top": 0.09509064257144928,
          "right": 0.4664609134197235,
          "bottom": 0.2678269147872925
        },
        "page": 0
      }
    },
    {
      "markdown": "<a id='bdaf2198-0fdc-4c94-be54-a49ca796ea0f'></a>\n\nQUANTITY\n\n48 Units",
      "type": "text",
      "id": "bdaf2198-0fdc-4c94-be54-a49ca796ea0f",
      "grounding": {
        "box": {
          "left": 0.06750398874282837,
          "top": 0.3068091869354248,
          "right": 0.3204823434352875,
          "bottom": 0.47341251373291016
        },
        "page": 0
      }
    },
    {
      "markdown": "<a id='65fe085e-b8c8-46e0-848c-f0c32ccf16e8'></a>\n\n<::scan_code: Barcode\n\nThis is a clear, well-defined linear barcode with distinct black bars on a white background, showing no visible quality issues.::>",
      "type": "scan_code",
      "id": "65fe085e-b8c8-46e0-848c-f0c32ccf16e8",
      "grounding": {
        "box": {
          "left": 0.11207544803619385,
          "top": 0.5374823212623596,
          "right": 0.8830909729003906,
          "bottom": 0.8660760521888733
        },
        "page": 0
      }
    },
    {
      "markdown": "<a id='9e551c40-3eaa-4d77-a219-50b7f4a57e05'></a>\n\n2847 0000 4812\n---\n",
      "type": "text",
      "id": "9e551c40-3eaa-4d77-a219-50b7f4a57e05",
      "grounding": {
        "box": {
          "left": 0.28996485471725464,
          "top": 0.9088556170463562,
          "right": 0.7057502269744873,
          "bottom": 0.9888754487037659
        },
        "page": 0
      }
    }
  ],
  "splits": [
    {
      "class": "page",
      "identifier": "page_0",
      "pages": [
        0
      ],
      "markdown": "<a id='69a645fe-8617-4be8-b66f-68d7788755c0'></a>\n\nSKU\nWH-2847-BLK\n\n<a id='bdaf2198-0fdc-4c94-be54-a49ca796ea0f'></a>\n\nQUANTITY\n\n48 Units\n\n<a id='65fe085e-b8c8-46e0-848c-f0c32ccf16e8'></a>\n\n<::scan_code: Barcode\n\nThis is a clear, well-defined linear barcode with distinct black bars on a white background, showing no visible quality issues.::>\n\n<a id='9e551c40-3eaa-4d77-a219-50b7f4a57e05'></a>\n\n2847 0000 4812\n---\n",
      "chunks": [
        "69a645fe-8617-4be8-b66f-68d7788755c0",
        "bdaf2198-0fdc-4c94-be54-a49ca796ea0f",
        "65fe085e-b8c8-46e0-848c-f0c32ccf16e8",
        "9e551c40-3eaa-4d77-a219-50b7f4a57e05"
      ]
    }
  ],
  "grounding": {
    "69a645fe-8617-4be8-b66f-68d7788755c0": {
      "box": {
        "left": 0.06628379225730896,
        "top": 0.09509064257144928,
        "right": 0.4664609134197235,
        "bottom": 0.2678269147872925
      },
      "page": 0,
      "type": "chunkText"
    },
    "bdaf2198-0fdc-4c94-be54-a49ca796ea0f": {
      "box": {
        "left": 0.06750398874282837,
        "top": 0.3068091869354248,
        "right": 0.3204823434352875,
        "bottom": 0.47341251373291016
      },
      "page": 0,
      "type": "chunkText"
    },
    "65fe085e-b8c8-46e0-848c-f0c32ccf16e8": {
      "box": {
        "left": 0.11207544803619385,
        "top": 0.5374823212623596,
        "right": 0.8830909729003906,
        "bottom": 0.8660760521888733
      },
      "page": 0,
      "type": "chunkScanCode"
    },
    "9e551c40-3eaa-4d77-a219-50b7f4a57e05": {
      "box": {
        "left": 0.28996485471725464,
        "top": 0.9088556170463562,
        "right": 0.7057502269744873,
        "bottom": 0.9888754487037659
      },
      "page": 0,
      "type": "chunkText"
    }
  },
  "metadata": {
    "filename": "pallet-label.png",
    "org_id": null,
    "page_count": 1,
    "duration_ms": 4226,
    "credit_usage": 3,
    "job_id": "y2xvbwlqc1p9ynwfkx4tx7q7q",
    "version": "dpt-2-20250919"
  }
}
```

## Markdown Structure

The `markdown` field includes a parsed chunk or a sequence of chunks.

Each chunk begins with an [HTML anchor tag](#anchor-tags) containing a unique identifier, followed by the chunk content.

For example, the following `markdown` field contains two chunks:

* A figure chunk (ID: `4c29090b-b75e-4d5f-95b6-24a7d5668486`) with a description of the image
* A text chunk (ID: `ae2e4e41-9443-4fb5-bced-199915f97dec`) containing formatted address information

```json theme={null}
"markdown": "<a id='4c29090b-b75e-4d5f-95b6-24a7d5668486'></a>\n\n<::An illustration of a sun with eight rays extending outwards.: figure::>\n\n<a id='ae2e4e41-9443-4fb5-bced-199915f97dec'></a>\n\n**Eliza Smith**\n123 Main St.\nMountain View, CA 94041"
```

### Anchor Tags

Each chunk begins with an HTML anchor tag containing the chunk's unique identifier.

The `id` attribute contains the UUID that matches the corresponding entry in the `chunks` array, enabling you to trace content back to its location in the original document.

```html theme={null}
<a id='chunk-uuid'></a>
```

### Content Format by Chunk Type

The Markdown content format varies based on the [chunk type](./ade-chunk-types):

* [Text-Based Chunks](#text-based-chunks)
* [Image-Based Chunks](#image-based-chunks)
* [Table Chunks](#table-chunks)
* [Spreadsheets](#spreadsheets)

#### Text-Based Chunks

For text-based chunks (`text`, `marginalia`), content appears as standard Markdown text:

```markdown theme={null}
<a id='chunk-uuid'></a>

## Heading Text

Paragraph content with **bold** and *italic* formatting.
```

#### Image-Based Chunks

Image-based chunks (`figure`, `logo`, `card`, `attestation`, `scan_code`) use a special delimiter format that wraps the caption or description:

```markdown theme={null}
<a id='chunk-uuid'></a>

<::Caption or description of the visual element: figure::>
```

#### Table Chunks

Table chunks (`table`) appear as HTML table markup.

Most table elements include unique `id` attributes. These IDs use the format `{page_number}-{base62_sequential_number}`, where the page number starts at 0 and the sequential number increments for each element within the page.

If a page contains multiple tables, the ID numbering continues sequentially across all tables on that page.

Table cells that span multiple rows or columns include `rowspan` or `colspan` attributes in the HTML markup.

This ID system allows you to trace individual cells, rows, and tables back to their locations in the original document. The [JSON response](./ade-json-response#table-cell-position-information) also includes position information (row, column, rowspan, colspan) for each table cell in the grounding object.

```markdown theme={null}
<a id='chunk-uuid'></a>

<table id="0-1">
<tr><td id="0-2" colspan="2">Product Summary</td></tr>
<tr><td id="0-3">Product</td><td id="0-4">Revenue</td></tr>
<tr><td id="0-5">Hardware</td><td id="0-6">15,230</td></tr>
<tr><td id="0-7">Software</td><td id="0-8">8,540</td></tr>
</table>
```

#### Spreadsheets

When you parse spreadsheets, data is identified as `table` chunks, and embedded images or charts are identified as `figure` chunks. Table chunks appear as HTML table markup.

Most table elements include unique `id` attributes. These IDs use the format `{tab_name}-{cell_reference}`, where the tab name is the name of the spreadsheet tab and the cell reference uses standard spreadsheet notation (column letter followed by row number, such as A1, B2, or C3).

The table itself uses a range-based ID format: `{tab_name}-{start_cell}:{end_cell}` (for example, `Sheet 1-A1:B4`).

This ID system allows you to trace individual cells back to their locations in the original spreadsheet.

For example, here is a screenshot of a spreadsheet, followed by the Markdown output.

<img src="https://mintcdn.com/landingaitest/Ld5cLlhMmp5eXJDU/images/spreadsheet.png?fit=max&auto=format&n=Ld5cLlhMmp5eXJDU&q=85&s=f7c0a4b4e666625e7eb51b5c3b00c076" alt="Spreadsheet" width="358" height="137" data-path="images/spreadsheet.png" />

```markdown theme={null}
{
  "markdown": "<a id='Sheet 1-A1:B4-chunk'></a>\n\n<table id='Sheet 1-A1:B4'>\n  <tr>\n    <td id='Sheet 1-A1'>Program</td>\n    <td id='Sheet 1-B1'>Interest Rate</td>\n  </tr>\n  <tr>\n    <td id='Sheet 1-A2'>15 Year Fixed-Rate Mortgage</td>\n    <td id='Sheet 1-B2'>0.05125</td>\n  </tr>\n  <tr>\n    <td id='Sheet 1-A3'>30 Year Fixed-Rate Mortgage</td>\n    <td id='Sheet 1-B3'>0.05875</td>\n  </tr>\n  <tr>\n    <td id='Sheet 1-A4'>10/1 ARM</td>\n    <td id='Sheet 1-B4'>0.05625</td>\n  </tr>\n</table>",
  "type": "table",
  "id": "Sheet 1-A1:B4",
  "grounding": null
    }
```

<Info>For a list of supported spreadsheet types, go to [Supported File Types](./ade-file-types). </Info>

### Chunk Separators

Chunks are separated by double newlines (`\n\n`), except for the final chunk in the document.

## How do I find the Markdown response for the ADE Parse Jobs API?

If you call the [ADE Parse Jobs](https://docs.landing.ai/api-reference/tools/ade-parse-jobs) API, the API responds with the `job_id`. The parsing results, including the `markdown` field, are returned when you check the parsing job status with the [ADE Get Parse Jobs](https://docs.landing.ai/api-reference/tools/ade-get-parse-jobs) API.
