Add a Table to Squarespace with Markdown — the Workaround That Works
Squarespace's Markdown block doesn't render tables — but its Code Block does render HTML.
Why your Markdown table isn't showing up in Squarespace
Squarespace's Markdown block supports the basics — headings, bold, italic, lists, links — but it does not render Markdown tables. This is a long-standing, documented limitation. If you've pasted a Markdown table into a Markdown block and seen it come out as a wall of pipe characters (|), this is why.
The good news: Squarespace's Code Block does render HTML. So the fix is to convert your Markdown table to HTML and paste the HTML into a Code Block instead. The table renders perfectly and inherits your site's styling.
How to add a Markdown table to a Squarespace page (5 steps)
Markdown tables look like this:
| Plan | Price | Best for |
|------------|--------|--------------------|
| Personal | $16/mo | Personal sites |
| Business | $23/mo | Small businesses |
| Commerce | $36/mo | Online stores |- 1
Write your table in Markdown (or paste it from anywhere)
You can write it by hand, copy it from a Notion page, ChatGPT, a markdown notes app, or a spreadsheet (most spreadsheets can export to Markdown via copy-paste extensions).
- 2
Paste it into the editor on this page
The left panel is preloaded with a sample table — replace it with yours. The HTML appears on the right instantly.
- 3
Click "Copy HTML for Squarespace"
The button copies the HTML and automatically applies a CSS preset that matches Squarespace's default typography (your table will look like it belongs to your site, not like an alien object).
- 4
In Squarespace, add a Code Block where you want the table
In the Squarespace editor, click the + to add a new block. Choose Code (under "More" if it's not in your favorites). Don't pick the Markdown block — that's the one that doesn't render tables.
- 5
Paste the HTML into the Code Block
Click into the Code Block and paste (
⌘/Ctrl + V). Make sure the HTML option is selected (not "CSS" or "JavaScript"). The Code Block will render your table immediately in the preview. Save the page. Your table is live.
What the output looks like
The HTML this tool produces uses semantic table markup — <table>, <thead>, <tbody>, <th>, <td> — with column alignment preserved and a small CSS preset that matches Squarespace's typography. The result:
- Looks native — uses your site's fonts, colors, and spacing.
- Responsive — wraps gracefully on mobile (no horizontal scroll on phones).
- Accessible — proper
<th scope="col">headers, so screen readers announce the table correctly. - Editable — you can tweak the CSS in the Code Block if you want to customize colors, borders, or spacing.
Common questions about the workaround
Because Squarespace's Markdown block supports basic Markdown but explicitly does not render tables. The Code Block does render HTML, so the standard workaround is to convert your Markdown table to HTML and paste the HTML into a Code Block.
Yes — the HTML output includes responsive CSS so the table wraps gracefully on phones. No horizontal scrolling, no cut-off columns.
Yes — re-edit your Markdown source, run it through the converter again, and replace the HTML in the Code Block. Many users keep the original Markdown in a notes app for easy re-editing.
Yes — the included CSS preset uses Squarespace's default font stack and spacing, so the table inherits your site's typography automatically. If you've heavily customized your site's styling, you can tweak the CSS in the Code Block to match.
Yes — including the Personal plan. The Code Block is available on every Squarespace plan (it's not a paid feature).
Yes — Markdown links work inside Markdown tables, and they get converted to proper HTML <a> tags. Just write [link text](https://example.com) inside any cell.
Yes — Markdown image syntax () inside a table cell converts to a proper HTML <img> tag. Keep image sizes reasonable so the table doesn't blow out the column widths.
Markdown tables don't support cell merging. If you need merged cells, write the table directly in HTML and paste it into the Code Block — skip this converter for that case.
Because plugins add another point of failure, slow your page down, and often cost money. Pasting native HTML into a Code Block is faster, free, and doesn't depend on a third-party service that might disappear.
Yes — the conversion happens in your browser. Your table never leaves your computer. Open developer tools → Network tab to verify: zero requests fire while you convert.
This same workaround works for other website builders too
The "convert Markdown table to HTML, paste into a code block" pattern works almost everywhere. Quick notes for the most common platforms:
WordPress
Use a "Custom HTML" block in the Gutenberg editor (or the "Code" block in the classic editor) and paste the HTML there.
Toggle the WordPress preset in the converter to add wp-block-table class names so the table inherits your theme's table styling.
Wix
Add an "Embed Code" element from the Wix editor and paste the HTML.
Wix renders the table inside a fixed-size iframe by default — use the converter's "Inline CSS" toggle to make sure styling carries through.
Webflow
Add an "Embed" element (the </> icon) inside any section and paste the HTML.
Webflow renders the embed inline, so the table inherits surrounding typography automatically.
Notion
Notion has its own native table feature — use that instead of pasting HTML when you can.
But if you're pasting from a Markdown source, the HTML output here also pastes cleanly into a Notion code block.
Ghost / Substack / Medium
All three accept HTML in a "raw HTML" or "code" block.
Same workflow: convert here, paste there.
What if I need to convert HTML back to Markdown?
If you have an existing HTML table (from a webpage, a Google Doc export, or somewhere else) and want it as Markdown for a notes app, GitHub README, or Obsidian vault, switch to the HTML → Markdown tab at the top.