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

   Build a small 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

   Bring your spreadsheet cells

   Use the table builder above to paste a spreadsheet selection or import a CSV. The first row becomes the header. You can also start blank and type directly into the cells.

3. 03

   Choose a style and check the phone preview

   Choose Sage, Ink, or Rose, then switch to the phone-width preview. Shorten cells or split the table if the text looks too small. The preview is an approximation, so check your actual test email too.

4. 04

   Copy or download the table image

   Use Copy image to put a PNG on your clipboard. If image copying is unavailable or the paste does not work, use Download PNG and insert the file with Substack’s image button.

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.

| Story | Format | Status |
| --- | --- | --- |
| Small rituals | Essay | Draft |
| Reading notes | List | Ready |
| Sunday letter | Letter | Idea |

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

   Allow clipboard access and try Copy image again. If the browser or destination does not accept the image, use Download PNG and upload the file with Substack’s image button.

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.