Getting Started·6 min read·

Tables, embeds, galleries, buttons and footnotes in the post editor

How to insert tables, provider embeds, image galleries, call-to-action buttons, and footnotes, and what each one looks like to your readers.

The post editor handles more than text and images. This article covers tables, embeds, galleries, buttons, and footnotes: how to insert each one, what readers see, and the one limit worth knowing for each.

Tables

Type /Table on an empty line to insert a 3 by 3 table with a header row, then fill in the cells in place.

For readers, a row made entirely of header cells renders as the table head, and the optional table caption renders below the table.

One thing to know: in the Markdown export the caption becomes a plain line above the table, because pipe tables have no caption syntax.

Embeds

There are two ways to add an embed. Type /Embed to insert an embed block, or paste a YouTube, Vimeo, Spotify, SoundCloud, CodePen, Instagram, Pinterest, or LinkedIn URL by itself on an empty line and the editor converts it into an embed automatically.

Readers see a facade card with the title, the provider name, and a thumbnail when one is available. The actual player loads only when a reader clicks the facade, so a post with several videos still loads quickly.

A pasted URL first appears as a link-style card with no thumbnail. Open the embed inspector and confirm it (blur the field, press Enter, or use the re-resolve button) to load the title and thumbnail. A URL from an unlisted host never becomes a player; it stays a plain link card.

Galleries

Type /Gallery to insert a multi-image grid, then add images in the inspector. Each image can carry its own alt text and caption, the grid can use 2, 3, or 4 columns, and an optional lightbox lets readers view images full size.

Readers see a grid of figures. An image with a caption shows it under the image, and the gallery as a whole can carry its own caption.

The limit: a gallery holds at most 24 images, and the editor warns once you pass 12.

Buttons

Type /Button to insert a call-to-action. A button is a styled link: it needs a label and a destination, and you can pick a primary, secondary, or outline style, left, center, or right alignment, and whether it opens in a new tab.

The label cannot be empty. If the destination is not a safe link, readers see the label as plain text instead of a link, never a dead or unsafe anchor.

Footnotes

Type /Footnote to insert a numbered reference at the cursor. The reference shows as a superscript number in the text, and the note itself lives at the end of the post.

Readers see a superscript [1] that jumps down to the numbered note. Numbers follow the order the references appear in, so if you move a paragraph the numbering follows it.

Exporting and safety

All five block types are covered by the Markdown export. Tables become pipe tables, embeds become a link plus caption, galleries become a list of images, buttons become a plain link, and footnotes become [^1] references with their definitions collected at the end of the document.

Link safety is enforced in one place for every link-like field: a link, button destination, or embed URL is kept only when it is an http or https URL, a mailto address, a site-relative path, or an in-page #anchor. Anything else, such as a javascript: or data: URL, is stripped, and the text stays visible without the link. Typing a bare address like example.com into a link field is fine; the editor adds https:// for you.