Markdown

Block (bodiless). The markdown is never stored in the page body.

Markdown (Capable)

Markdown macro (Capable)

Its own full-screen dialog titled 'Configure Markdown'. Pick where your markdown comes from (Markdown from scratch, Markdown from URL, Markdown from file, Studio, templates or examples), then use the live editor to set a title, a description and 'Show border'. Select Save when you're done. It isn't a simple settings form.

Visible to logged-out readers of public pages in both products, except for documents that come from a URL.

Only in the Suite. The export contains your markdown source in a code block, not the rendered text.

On a published Capable Site, your markdown appears as properly formatted content, with the Title as a heading. External images are copied onto the site.

Title

Free text, up to 50 characters in the editor

Empty

Meant as the heading above the document, shown only when Show border is on. In practice the title you type is saved with the document itself, not in the macro's settings.

Show border (Options)

A single 'Show border' choice

Off

Draws a thin rounded border with padding, and turns on the title strip with a Maximise button. The border carries over to a published Capable Site.

URL

Any http or https address of a markdown file

Empty (the field starts with an example address)

Fetches the markdown when someone views the page, so the page follows the source file. It isn't copied in. Links to GitHub, GitLab and Bitbucket pages are switched to the raw file automatically. Relative image paths resolve against the document's own folder.

Attachment

A markdown file attached to the same page

Not set

Shows the attachment's contents. It takes priority over a URL and over markdown stored on the page. Only the 'Markdown from file' picker sets it, and it offers markdown and plain text files only.

The section the dialog opens on. You get a blank live editor, and your text is saved as markdown stored under the page. 'Upload file', or drag and drop, accepts .md, .markdown, .mdx and .txt files. The content is added after a blank line, and an empty title takes the file name (first 50 characters, without the extension).

Enter an address, preview the fetched markdown, then save. The page keeps the address rather than a copy, so it stays live. If the fetch fails, you see the error and 'Please ensure the provided URL returns raw text content'.

Pick a file already attached to the page, or drop or upload a .md, .markdown, .mdx or .txt file onto the page, then render it.

'Generate markdown with AI'. It needs AI features turned on for your site, so it never appears in the standalone Markdown app.

Choosing a template copies its markdown into your macro, and from then on the two are separate. The word 'template' at the end of the title is dropped. If you want a live link to a template, use the reference macro instead.