Markdown & Diagrams

Emberflow renders standard GitHub Flavored Markdown with a few extras.

emberDiagrams

Emberflow supports several rich content types beyond plain text:

Use fenced code blocks for syntax highlighting, standard markdown tables, blockquotes for callouts, and inline <explainer> blocks for interactive visualisations.

Tables

Standard markdown tables render with alternating row stripes:

Code Blocks

Syntax highlighting is automatic based on the language tag:

// Example: publish a document via the API
const res = await fetch('https://emberflow.ai/api/docs', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title: 'My Architecture Doc',
    slug: 'my-architecture-doc',
    content: markdownString,
    visibility: 'public'
  })
});

Callouts

Use blockquotes for callouts and important notes:

Emberflow re-renders documents entirely client-side, so even complex emberDiagrams load fast with no server processing delay.