How to Add a Table in a Substack Post (Without a Blurry Screenshot)

Does Substack support tables?

Substack supports headings, lists, quotes, links, inline code, images, and several embedded blocks, but it does not currently provide a native table control in the post editor. Substack also states that its post editor does not support Markdown as an input format. That is why a GitHub-style table pasted directly into a draft usually remains plain text instead of becoming rows and columns.

A table also has to survive two renderers: the web post and the HTML email received by subscribers. A layout that looks acceptable in the browser can overflow, shrink, or lose borders in an email client. A carefully sized image is less flexible than a real HTML table, but it is much more predictable across those destinations.

Add a table to Substack step by step

1. 01

   Write a small Markdown table

   Keep it to roughly three or four columns for email. Put short labels in the first row and concise values in each cell.

2. 02

   Paste the complete draft into StackDraft

   Open StackDraft, replace the sample with your Markdown, and confirm that the table appears correctly in the preview. Your draft stays in your browser.

3. 03

   Check the publishing warnings

   StackDraft flags wide tables, long tables, and unusually long cells before they become hard-to-read images. Shorten or split the table if needed.

4. 04

   Copy the title and body separately

   Use Copy title for Substack’s title field. Then use Copy body; StackDraft converts each table into a high-resolution PNG and places the prepared rich text on your clipboard.

5. 05

   Paste into Substack and add alt text

   Paste into a desktop Substack draft, select the inserted table image, and use its image menu to add a concise description of the table’s purpose and key values.

6. 06

   Send yourself a test email

   Review the draft at desktop and phone widths, then send a test email. Check that the text is large enough without zooming and that no important column is cropped.

Markdown table example you can copy

The separator row is required. Colons in that row control alignment in many Markdown renderers, although left-aligned text is usually easiest to read in a newsletter. Keep currency, dates, and other compact values consistent down each column.

| Plan | Price | Best for |
| --- | ---: | --- |
| Free | $0 | New readers |
| Monthly | $8 | Regular readers |
| Annual | $80 | Long-term supporters |

Four ways to publish a table on Substack

There is no single best representation for every dataset. Choose based on how readers will consume the information, not on which method takes the fewest clicks.

Make the table readable on mobile and in email

Substack lets authors edit an image’s alt text from the image menu. Alt text should explain what the image is doing in context, not reproduce a massive table cell by cell. For a complex or data-heavy table, add a short text summary immediately before or after the image and link to the full accessible dataset.

• Prefer three columns; use four only when every cell is short.
• Move explanations below the table instead of placing paragraphs inside cells.
• Use sentence case and plain labels rather than abbreviations that need a legend.
• Split a table by topic when it grows beyond about ten to fifteen rows.
• Do not communicate status by color alone; include words such as Yes, No, Pass, or Needs review.
• Summarize the most important conclusion in the surrounding paragraph so the image is not the only source of meaning.

Troubleshooting common table problems

1. 01

   The pipes and dashes are visible

   You pasted raw Markdown into Substack. Render it in StackDraft first, then copy the prepared body rather than copying from the editor pane.

2. 02

   The table is too small on a phone

   Reduce the number of columns, shorten cell text, or split the content into two tables. Increasing image dimensions does not fix an overstuffed layout.

3. 03

   The image did not transfer

   Use a Chromium-based desktop browser, allow clipboard access, and try Copy body again. If the destination strips the clipboard image, recreate the smaller table as a list or upload an exported image manually.

4. 04

   The information changes frequently

   Publish a concise snapshot in the post and link to the maintained spreadsheet or source. An emailed image cannot update after it reaches a subscriber’s inbox.