Markdown blocks

Simplify the writing process using blocks that support Markdown language.

Last updated April 1, 2024

Use Markdown blocks to add text to your site with the Markdown language. Markdown blocks support lists, links, bolded and italicized text, and block quotes. To add custom HTML, CSS, or JavaScript, use code blocks.

Note

Markdown language is an advanced modification that falls out of the scope of Squarespace support. We can help with adding a Markdown block to your site, but not further set up or troubleshooting of Markdown language.

Watch a video

This video applies to version 7.0.

Before you begin

Add a Markdown block

To add a Markdown block:

  1. Edit a page or post, click Add Block or an insert point, and select Markdown from the menu. For help, visit Adding content with blocks.
  2. Open the block editor by clicking the pencil icon on the block.
  3. Add Markdown text in the Markdown box.
  4. You can highlight your Markdown text and use the toolbar to bold or italicize text, create links, use headings, add block quotes, or make lists. If your site is on version 7.0, click Apply to publish your changes.

Accessing this feature

On the Squarespace app, it's not possible to add blocks to Fluid Engine sections. To learn more, visit Adding content with blocks.

  1. Tap More, then tap Pages.
  2. Tap the title of the page you want to edit. If your site is on version 7.1, then tap Preview to open the editor.
  3. Tap Edit or the pencil icon in the top-left corner.
  4. Tap the + icon in the top-right corner to open the block menu.
  5. Tap Markdown to add a Markdown block.
  6. At the bottom of your screen, tap below Preview and Markdown to open the empty Markdown box.
  7. Enter your Markdown text. The Preview tab displays the text as it will render on your site. Tap the Markdown tab to see the formatting.
  8. Tap Done or to save your changes.

Use Markdown as your default editor

You can change the default blocks that appear in pages and posts to Markdown blocks instead of text blocks:

  1. Open the Developer tools panel.
  2. Click Default Text Editor.
  3. Check Markdown Editor, then click Save.

My cursor isn't lined up with the text

While editing the Markdown block, the cursor may sometimes not align with the text. This can occur when first opening the block for editing and clicking into the Markdown box.

To realign the cursor with your text:

  1. Click into the Markdown box.
  2. Press Enter.
Footer Image
  • Get help from our community

  • Get help from our community on advanced customizations.

  • Hire a Squarespace Expert

  • Stand out online with the help of an experienced designer or developer.