How to Use the Substack Editor

Version: 4 (current) | Updated: 11/12/2025, 6:40:10 PM

Added description

Description

How to Use the Substack Editor

Overview

A plain‑text tutorial (ID 01K9WNR269X1BB87PZDD71DYRC) created in 2023 by Substack. The document explains how to use the Substack editor, covering basic formatting options, headings, block quotes, and embedding content. It is part of the “Substack Editor Tutorials” collection archived by PINAX. The file is in English and has no copyright restrictions.

Background

Substack, founded in 2017, is a newsletter‑publishing platform that combines a content management system with a subscription‑payment model. The tutorial was produced to assist new users in navigating the platform’s editor, which is a WYSIWYG interface that supports Markdown‑style syntax and rich media embedding. The material was archived by the PINAX system, a digital preservation tool used by the “test” institution.

Contents

  • Introduction – Overview of the editor’s interface.
  • Formatting Options – How to apply bold, italic, lists, and code blocks.
  • Headings – Creating H1–H3 levels and their visual impact.
  • Block Quotes – Syntax and styling guidelines.
  • Embedding Content – Instructions for inserting images, videos, tweets, and other media.
  • Best Practices – Tips for maintaining readability and accessibility.
  • The tutorial is concise, with step‑by‑step instructions and illustrative examples. It does not cover advanced features such as custom CSS, API integration, or multi‑column layouts.

    Scope

  • Temporal: Published in 2023; reflects the editor’s state at that time.
  • Geographic: Global, as Substack is an online service.
  • Thematic: Focuses exclusively on the Substack editor’s core editing functions.
  • Included: Basic text formatting, headings, block quotes, and media embedding.
  • Excluded: Advanced customization, third‑party integrations, or platform‑wide policy details.

This document serves as a quick reference for new Substack users and can be used in training materials or

Entities

(loading...)

Entity Relationships

(loading...)

Raw Cheimarros Data

@file_pinax:metadata {title: "How to Use the Substack Editor", type: "Text", creator: "Substack", created: @date_2023, language: "en", subjects: ["Substack", "Editor Tutorial", "Formatting Options", "Block Quotes", "Headings", "Embedding Content"], description: "A tutorial on how to use the Substack editor, including formatting options, headings, and embedding content."}

@file_125962877_how_to_use_the_substack_editor:document {title: "How to Use the Substack Editor", year: @date_2023, format: "HTML", source_file: @file_pinax}

@substack_editor:software {description: "Web‑based rich‑text editor used by writers on the Substack platform to create, format, and publish posts."}

@substack_editor_tutorial:document {title: "How to Use the Substack Editor", year: @date_2023, created_from: @file_125962877_how_to_use_the_substack_editor}

@block_quotes:concept {definition: "A block‑level quotation style that visually separates quoted text from surrounding content."}
@bold:concept {definition: "Text styling that makes characters appear heavier to emphasize importance."}
@italic:concept {definition: "Text styling that slants characters to indicate emphasis or titles."}
@links:concept {definition: "Hypertext elements that connect a piece of text or media to a URL."}
@headings:concept {definition: "Hierarchical text elements (e.g., H1‑H6) used to structure a document."}
@embeddings:concept {definition: "In‑line inclusion of external media such as images, videos, or audio within a post."}
@image_embedding:concept {definition: "Embedding of an image file directly into the editor content."}
@tweet_embedding:concept {definition: "Embedding of a Twitter post by pasting its URL on a new line."}
@youtube_embedding:concept {definition: "Embedding of a YouTube video via its URL on a new line."}
@vimeo_embedding:concept {definition: "Embedding of a Vimeo video via its URL on a new line."}
@spotify_embedding:concept {definition: "Embedding of a Spotify album/track via its URL on a new line."}
@soundcloud_embedding:concept {definition: "Embedding of a SoundCloud track via its URL on a new line."}
@settings_button:ui_element {description: "Button in the Substack editor UI that opens post settings, located left of the Publish button."}
@publish_option:concept {types: ["Publish", "Publish & Send"], description: "Two publishing modes: Publish only to the web, or Publish and simultaneously send the post by email."}
@help_center:organization {description: "Substack’s support portal for user assistance."}
@support_contact:concept {description: "Form for submitting support requests to Substack."}

@file_125962877_how_to_use_the_substack_editor -> documents -> @substack_editor_tutorial

@substack_editor_tutorial -> teaches -> @substack_editor:software

@substack_editor_tutorial -> covers -> [@block_quotes, @bold, @italic, @links, @headings, @embeddings]

@substack_editor_tutorial -> demonstrates -> [@image_embedding, @tweet_embedding, @youtube_embedding, @vimeo_embedding, @spotify_embedding, @soundcloud_embedding]

@substack_editor_tutorial -> includes -> @settings_button:ui_element

@substack_editor_tutorial -> explains -> @publish_option:concept

@substack_editor_tutorial -> provides -> @help_center:organization {url: "https://support.substack.com/hc/en-us"}

@substack_editor_tutorial -> provides -> @support_contact:concept {url: "https://support.substack.com/hc/en-us/requests/new"}

Metadata

Version History (4 versions)

  • ✓ v4 (current) · 11/12/2025, 6:40:10 PM
    "Added description"
  • v3 · 11/12/2025, 6:38:24 PM · View this version
    "Added knowledge graph extraction"
  • v2 · 11/12/2025, 6:37:46 PM · View this version
    "Added PINAX metadata"
  • v1 · 11/12/2025, 6:37:36 PM · View this version
    "Reorganization group: Substack_Editor_Tutorials"

Additional Components

125962877.how-to-use-the-substack-editor.html
<p>Hi! This is a draft post. Did you know that there are a bunch of nice formatting options in this editor? For example:</p><blockquote><p>Block quotes are a nice way to put a quote or excerpt from a source. They make it clear that it is a quote.</p></blockquote><p>Of course, you can also do <strong>bold, </strong><em>italic</em>, <a href="https://www.substack.com">links</a>,<strong> </strong>and all that good stuff.</p><h3>Headings and Embeddings</h3><p>You can have headings in posts. Just use the “Style”<em> </em>list in the toolbar. You can also embed different types of content. To add an image, just drag it in here or use the image selector tool in the toolbar.</p><div class="captioned-image-container"><figure><a class="image-link image2" target="_blank" href="https://substackcdn.com/image/fetch/$s_!2WtI!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!2WtI!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 424w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 848w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 1272w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 1456w" sizes="100vw"><img src="https://bucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com/public/images/fec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024" data-attrs="{&quot;src&quot;:&quot;https://bucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com/public/images/fec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:null,&quot;width&quot;:null,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:null,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!2WtI!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 424w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 848w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 1272w, https://substackcdn.com/image/fetch/$s_!2WtI!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fbucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com%2Fpublic%2Fimages%2Ffec21723-9bb2-4ea6-8fc2-09d17ba3bd1a_4032x3024 1456w" sizes="100vw" fetchpriority="high"></picture><div></div></div></a></figure></div><p>For a tweet, YouTube video, Vimeo video, Spotify track, or SoundCloud embed, just paste the relevant link on a new line (don’t grab the embed code; it won’t work).</p><div data-component-name="Twitter2ToDOM" class="tweet" data-attrs="{&quot;url&quot;:&quot;https://twitter.com/hamishmckenzie/status/941694455853101056&quot;,&quot;full_text&quot;:&quot;Twitter is an amazing tool and an awful place.&quot;,&quot;username&quot;:&quot;hamishmckenzie&quot;,&quot;name&quot;:&quot;Hamish McKenzie&quot;,&quot;date&quot;:&quot;Fri Dec 15 15:40:28 +0000 2017&quot;,&quot;photos&quot;:[],&quot;quoted_tweet&quot;:{},&quot;retweet_count&quot;:1,&quot;like_count&quot;:5,&quot;expanded_url&quot;:{},&quot;video_url&quot;:null,&quot;belowTheFold&quot;:false}"><a class="tweet-link-top" href="https://twitter.com/hamishmckenzie/status/941694455853101056" target="_blank"><div class="tweet-header"><img class="tweet-header-avatar" src="https://substackcdn.com/image/twitter_name/w_96/hamishmckenzie.jpg" alt="Twitter avatar for @hamishmckenzie"><div class="tweet-header-text"><span class="tweet-author-name">Hamish McKenzie </span><span class="tweet-author-handle">@hamishmckenzie</span></div></div><div class="tweet-text">Twitter is an amazing tool and an awful place.</div></a><a class="tweet-link-bottom" href="https://twitter.com/hamishmckenzie/status/941694455853101056" target="_blank"><div class="tweet-footer"><span class="tweet-date">3:40 PM ∙ Dec 15, 2017</span><hr><div class="tweet-ufi"><span href="https://twitter.com/hamishmckenzie/status/941694455853101056/likes" class="likes"><span class="like-count">5</span>Likes</span><span href="https://twitter.com/hamishmckenzie/status/941694455853101056/retweets" class="retweets"><span class="rt-count">1</span>Retweet</span></div></div></a></div><div id="youtube2-ZoEUu1XHL7U" class="youtube-wrap" data-attrs="{&quot;videoId&quot;:&quot;ZoEUu1XHL7U&quot;,&quot;startTime&quot;:null,&quot;endTime&quot;:null}" data-component-name="Youtube2ToDOM"><div class="youtube-inner"><iframe src="https://www.youtube-nocookie.com/embed/ZoEUu1XHL7U?rel=0&amp;autoplay=0&amp;showinfo=0&amp;enablejsapi=0" frameborder="0" loading="lazy" gesture="media" allow="autoplay; fullscreen" allowautoplay="true" allowfullscreen="true" width="728" height="409"></iframe></div></div><div id="vimeo-288003645" class="vimeo-wrap" data-attrs="{&quot;videoId&quot;:&quot;288003645&quot;,&quot;videoKey&quot;:&quot;&quot;,&quot;belowTheFold&quot;:true}" data-component-name="VimeoToDOM"><div class="vimeo-inner"><iframe src="https://player.vimeo.com/video/288003645?autoplay=0" frameborder="0" gesture="media" allow="autoplay; fullscreen" allowautoplay="true" allowfullscreen="true" loading="lazy"></iframe></div></div><p></p><iframe class="spotify-wrap album" data-attrs="{&quot;image&quot;:&quot;https://i.scdn.co/image/4988546859334f9a5a3fa4acedc5aea275929026&quot;,&quot;title&quot;:&quot;LOVE. FEAT. ZACARI.&quot;,&quot;subtitle&quot;:&quot;Kendrick Lamar, Zacari&quot;,&quot;description&quot;:&quot;&quot;,&quot;url&quot;:&quot;https://open.spotify.com/album/4eLPsYPBmXABThSJ821sqY&quot;,&quot;belowTheFold&quot;:true,&quot;noScroll&quot;:false}" src="https://open.spotify.com/embed/album/4eLPsYPBmXABThSJ821sqY" frameborder="0" gesture="media" allowfullscreen="true" allow="encrypted-media" loading="lazy" data-component-name="Spotify2ToDOM"></iframe><div class="soundcloud-wrap" data-attrs="{&quot;url&quot;:&quot;https://api.soundcloud.com/tracks/522545169&quot;,&quot;title&quot;:&quot;UBI,  Automation &amp; Society in the US: Andrew Yang &amp; Azeem Azhar in Conversation by Exponential View&quot;,&quot;description&quot;:&quot;Azeem Azhar speaks with Andrew Yang, entrepreneur and author, who is standing for President in the 2020 U.S. elections. At the heart of Andrew's platform is the \&quot;freedom dividend\&quot;, a universal basic income of $1,000, payable to all Americans every month. Azeem and Andrew discuss core ideas behind Andrew's platform, why they are necessary, and how to get there. www.exponentialview.co&quot;,&quot;thumbnail_url&quot;:&quot;http://i1.sndcdn.com/artworks-000431458485-eu1ioh-t500x500.jpg&quot;,&quot;author_name&quot;:&quot;Exponential View&quot;,&quot;author_url&quot;:&quot;https://soundcloud.com/exponentialview&quot;,&quot;targetUrl&quot;:&quot;&quot;}" data-component-name="SoundcloudToDOM"><iframe src="https://w.soundcloud.com/player/?auto_play=false&amp;buying=false&amp;liking=false&amp;download=false&amp;sharing=false&amp;show_artwork=true&amp;show_comments=false&amp;show_playcount=false&amp;show_user=true&amp;hide_related=true&amp;visual=false&amp;start_track=0&amp;url=https%3A%2F%2Fapi.soundcloud.com%2Ftracks%2F522545169" frameborder="0" gesture="media" scrolling="no" allowfullscreen="true"></iframe></div><p>To delete a post, click on the <strong>Settings</strong> button (just to the left of Publish), and scroll down and find the delete button. </p><h4>Publishing Changes</h4><p>You have two publishing options: </p><ol><li><p><strong>Publish</strong> – this publishes your post only to the web. </p></li><li><p><strong>Publish &amp; Send</strong> – this publishes your post to the web and at the same time sends the post out by email. </p></li></ol><p>Note: Once you have sent an email out, the only way to send it again is to create an entirely new post. Any edits you make to a post that has already been published will only be reflected on the web. So, there’s no need to worry about accidentally spamming your subscribers with repeat emails. </p><p>Finally, if you import posts from some other site’s archives, you can backdate them so they are published in the correct order and associated with the correct publication dates. To do so, after you have published a post, go into that post’s Settings (just to the left of the Publish button) and select the desired date. </p><p>If you have any questions, you can check out our <a href="https://support.substack.com/hc/en-us">Help Center</a> or <a href="https://support.substack.com/hc/en-us/requests/new">contact support</a>!</p><p></p><p></p>

Parent

01K9WNQ8WWJFKDX2NPZV091RTD

No children (leaf entity)