Markdown block
A block of standard GitHub-flavored markdown, for text you didn't hand-assemble into rich text.
markdown takes one raw markdown string and lets Slack do the parsing, instead of you building a
rich_text tree or a mrkdwn string by hand. Slack expands it into the same headings, lists,
dividers, code blocks, and tables you’d get from other blocks. It’s meant for text an LLM
produced, where you don’t control the exact markdown shape ahead of time.
Fields
typestring
Always markdown.
stringtextstring
Standard markdown-formatted text. Slack allows 12,000 characters across all markdown blocks in a payload, not per block. A block whose text is longer than 12,000 characters shows it as plain text, unparsed.
stringblock_id?string
A unique identifier for the block, up to 255 characters. Slack generates one if omitted.
stringA paragraph keeps its first 500 emphasis markers (*, _, ~) and brackets as markdown, far more
than a paragraph uses; from the next one on, the rest of the paragraph shows as written. Text
built to slow a markdown parser down still parses in a fraction of a second this way.
Examples
Inline styles
Headings and dividers
Headings past ### still render at the same size as ###. A line of --- renders as a divider.
Lists and quotes
Bulleted and numbered lists render like rich_text lists, with Slack’s bullet glyphs and the
numbers lined up under the bullets. A list, quote or code block gets the same paragraph gap as a
paragraph before whatever follows it:
Fenced code blocks
A fenced code block with a language tag renders with a language label and copy button, the same
chrome used by rich_text’s preformatted sections:
Tables
Standard GFM table syntax renders as a table, right inside the markdown text: