Note: While our most popular guides have been translated into Spanish, some guides are only available in English.

Markdown blocks

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.

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.

Before you begin

Watch a video

Add a Markdown block

To add a Markdown block:

  1. Edit a page or post, click an insert point, and select Markdown from the menu. For help, visit Adding content with blocks.
  2. Add Markdown text in the Markdown box.
  3. 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.
  4. Click Apply to save your changes.
  1. Tap the Pages icon.
  2. Tap the title of the page you want to edit.
  3. Tap Edit or the pencil icon in the top-right 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. In the Home menu, click Settings, then click Advanced.
  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.
Was this article helpful?
51 out of 179 found this helpful