Skip to main content
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

[block align=center] # Quarterly Review

​
Typography wrapper

[style font=georgia fontSize=18px lineHeight=1.5]Styled text[/style]

​
Color wrapper

[color=#336699]Accent text[/color]

​
Table of contents

[toc title=Contents levels=1,2,3 pageNumbers=true]

​
Enhanced table

[table]
[row]
[th]Name[/th]
[th]Status[/th]
[/row]
[row]
[td]Launch[/td]
[td]Ready[/td]
[/row]
[/table]

​
Image

![Roadmap](https://example.com/roadmap.png)

​
Guidance for agents

Always read the latest document content before editing. Even small whitespace changes between reads can cause oldString mismatches.
  • 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.