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

# Nylio markdown

> Reference for Nylio's enhanced markdown format used in document reads and writes.

Nylio document bodies use a custom enhanced markdown format. It is close to normal markdown, but it also includes Nylio-specific wrappers that preserve document structure, styling, tables, images, table of contents blocks, and collaboration state.

## MIME type and format

* MIME type: `text/x-nylio-enhanced-markdown`
* Format id: `nylio_enhanced_markdown`

## When to use it

* `documents_get` returns body content in this format.
* `documents_create` accepts initial body content in this format.
* `documents_replace` expects complete body content in this format.
* `documents_edit` replaces exact snippets copied from this format.

## Core rules

* Treat the exact markdown returned by Nylio as the source of truth.
* Preserve Nylio wrappers such as `[block ...]`, `[style ...]`, `[table]`, `[row]`, `[td]`, `[th]`, and `[toc ...]`.
* Use ordinary markdown for headings, paragraphs, lists, links, code fences, and emphasis where applicable.
* Do not convert enhanced tables into pipe tables unless you explicitly want a format conversion.
* Do not remove, invent, or rearrange collaboration markers or other structural wrappers.

## Common examples

### Heading with alignment

```md theme={null}
[block align=center] # Quarterly Review
```

### Typography wrapper

```md theme={null}
[style font=georgia fontSize=18px lineHeight=1.5]Styled text[/style]
```

### Color wrapper

```md theme={null}
[color=#336699]Accent text[/color]
```

### Table of contents

```md theme={null}
[toc title=Contents levels=1,2,3 pageNumbers=true]
```

### Enhanced table

```md theme={null}
[table]
[row]
[th]Name[/th]
[th]Status[/th]
[/row]
[row]
[td]Launch[/td]
[td]Ready[/td]
[/row]
[/table]
```

### Image

```md theme={null}
![Roadmap](https://example.com/roadmap.png)
```

## Guidance for agents

<Warning>
  Always read the latest document content before editing. Even small whitespace changes between reads can cause `oldString` mismatches.
</Warning>

* For localized edits, copy `oldString` verbatim from the latest read.
* For full rewrites, send the complete updated enhanced markdown body.
* If you see wrappers you do not recognize, preserve them unless the task explicitly requires changing them.