Block Types Reference

Blocks are the building elements of task steps. Each block has a type field that determines its behavior.

Input Block

Form fields that collect user input.

{
	"type": "input",
	"field": {
		"name": "field_name",
		"label": "Display Label",
		"kind": "text",
		"required": true,
		"placeholder": "Enter value...",
		"description_mdsvex": "Help text in **markdown**"
	}
}

See Form Field Reference for all field kinds.

Markdown Block

Formatted text content rendered as HTML.

{
	"type": "mdsvex",
	"content": "# Heading\n\nParagraph with **bold** and *italic* text.\n\n- List item 1\n- List item 2"
}

Supports: headings, bold, italic, strikethrough, links, images, lists, blockquotes, code blocks, and tables.

Table Block

Structured tabular data.

{
	"type": "table",
	"headers": ["Name", "Value", "Status"],
	"rows": [
		["Temperature", "72°F", "Normal"],
		["Pressure", "14.7 psi", "Normal"],
		["Humidity", "85%", "High"]
	],
	"alignments": ["left", "right", "center"],
	"caption": "Sensor readings at 12:00 UTC"
}

Image Block

Displays an image.

{
	"type": "image",
	"url": "https://example.com/screenshot.png",
	"alt": "Dashboard screenshot",
	"caption": "The new dashboard layout"
}

Callout Block

Highlighted message box for important information.

{
	"type": "callout",
	"severity": "warning",
	"title": "Important",
	"content": "This action cannot be undone."
}

PDF Block

Embedded PDF viewer.

{
	"type": "pdf",
	"url": "https://example.com/document.pdf",
	"filename": "contract.pdf",
	"caption": "Review the contract",
	"height": "600px"
}

Download Block

Downloadable files.

{
	"type": "download",
	"downloads": [
		{
			"url": "https://example.com/report.xlsx",
			"filename": "report.xlsx",
			"size": 245760,
			"mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
			"description": "Q4 sales report"
		}
	]
}

Divider Block

A horizontal line to visually separate content.

{
	"type": "divider"
}