Block Types Reference

Every MDER document is composed of blocks — discrete content units rendered in order. Each block has a type, content, optional props, and an ID. MDER supports 11 block types.

Block Schema

block structurejson

{
  "id": "blk_1",
  "type": "markdown",
  "content": "Your content here",
  "props": {},
  "order": 0
}

Parameter	Type	Required	Description
`id`	string	Required	Unique identifier within the document (max 64 chars)
`type`	string	Required	One of the 11 supported block types
`content`	string	Required	Block content — format depends on type (max 1MB)
`props`	object	Optional	Type-specific properties that control rendering
`order`	number	Optional	Display order (0-based). Blocks without order use array position.

markdown

The most versatile block type. Supports full GitHub Flavored Markdown including tables, task lists, strikethrough, autolinks, and more. If unsure which block to use, use markdown.

Props: None required.

Introduction

This project improves developer experience with a streamlined API.

Key Features

Auto-expiring links
Password protection
View tracking

code

Source code with syntax highlighting, optional line numbers, and file name display. Supports 200+ languages via Prism.js.

Parameter	Type	Required	Description
`language`	string	Optional ("text")	Language for syntax highlighting (e.g. "python", "typescript")
`filename`	string	Optional	File name displayed as a header above the code
`line_numbers`	boolean	Optional (true)	Show line numbers
`highlight_lines`	number[]	Optional	Line numbers to highlight

publish.py

import httpx

client = httpx.Client(
    base_url="https://api.mder.pro",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

response = client.post("/v1/documents", json={
    "title": "My Report",
    "content": "# Hello World"
})

image

Display an image with optional caption and alignment. The image URL must be publicly accessible.

Parameter	Type	Required	Description
`url`	string	Required	Image URL (must be publicly accessible)
`alt`	string	Optional	Alt text for accessibility
`caption`	string	Optional	Caption displayed below the image
`width`	number	Optional	Display width in pixels
`height`	number	Optional	Display height in pixels
`alignment`	string	Optional ("center")	"left", "center", or "right"

examplejson

{
  "id": "chart",
  "type": "image",
  "content": "Revenue growth chart",
  "props": {
    "url": "https://charts.example.com/revenue-q1.png",
    "caption": "Figure 1: Revenue Growth — Q1 2026",
    "alignment": "center"
  }
}

table

Structured tabular data. Content uses pipe-separated rows. The first row is treated as headers unless the headers prop is specified.

Parameter	Type	Required	Description
`headers`	string[]	Optional	Override headers (content starts at data rows)
`caption`	string	Optional	Table caption/title
`striped`	boolean	Optional (false)	Alternate row background colors
`alignment`	string[]	Optional	Per-column alignment: "left", "center", "right"

Weekly Metrics

Metric	This Week	Last Week	Change
Revenue	$52k	$48k	+8%
Users	1,240	1,180	+5%
Churn	1.8%	2.1%	-14%

heading

Explicit section heading with anchor link support. Use when you need precise control over heading levels and anchor IDs. For simple headings, use # syntax inside markdown blocks.

Parameter	Type	Required	Description
`level`	number	Required	Heading level: 1-6
`anchor`	string	Optional	Custom anchor ID for linking

Getting Started

callout

Highlighted informational box with type-based styling. Supports markdown content inside.

Parameter	Type	Required	Description
`type`	string	Required	"info", "warning", "error", "success", "tip", or "note"
`title`	string	Optional	Callout title/header
`collapsible`	boolean	Optional (false)	Whether the callout can be collapsed

⚠️ Save Your API Key

The API key is only shown once at creation. Store it securely.

✅ Deployment Complete

Deployment completed in 2m 34s.

3 services updated
0 errors

divider

A horizontal rule / section separator. Content can be empty.

quote

A styled block quotation. Supports markdown content.

The best way to predict the future is to invent it.

— Alan Kay

list

Structured list with ordered, unordered, or checklist styles. One item per line. For simple lists, prefer - item syntax in markdown blocks.

Parameter	Type	Required	Description
`style`	string	Required	"ordered", "unordered", or "checklist"
`start`	number	Optional (1)	Starting number for ordered lists

Set up API key
Create first document
Configure MCP server
Deploy to production

Register at mder.pro
Create an API key
Publish your first document
Share the URL

embed

Embedded external content via iframe. Use for YouTube videos, Figma designs, interactive charts, etc.

Parameter	Type	Required	Description
`url`	string	Required	URL to embed
`caption`	string	Optional	Caption below the embed
`width`	number	Optional (800)	Width for aspect ratio
`height`	number	Optional (450)	Height for aspect ratio
`provider`	string	Optional	Provider name (e.g. "youtube", "figma")

examplejson

{
  "id": "video",
  "type": "embed",
  "content": "Product demo video",
  "props": {
    "url": "https://www.youtube.com/embed/dQw4w9WgXcQ",
    "caption": "MDER.PRO Product Demo",
    "provider": "youtube"
  }
}

html

Raw HTML content. Use for custom widgets, badges, or SVG graphics. Sanitized by default.

Parameter	Type	Required	Description
`sanitize`	boolean	Optional (true)	Strip scripts and event handlers

⚠️ Security

HTML blocks with sanitize: true (default) strip <script> tags and event handlers. For untrusted content, always leave sanitization enabled.

v2.1.0Stable

Quick Reference Table

Type	Content Format	Key Props	Use Case
markdown	GFM Markdown	—	General rich text
code	Source code	language, filename	Code snippets
image	Alt text / desc	url, caption, alignment	Screenshots, diagrams
table	Pipe-separated rows	headers, striped, caption	Data tables
heading	Heading text	level, anchor	Section headers
callout	Markdown	type, title	Notices, warnings
divider	Empty	—	Section separators
quote	Markdown	—	Block quotes
list	One item per line	style	Lists, checklists
embed	Fallback URL	url, width, height	YouTube, Figma
html	HTML string	sanitize	Custom widgets