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:
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
Typography wrapper
Color wrapper
Table of contents
Enhanced table
Image
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.