Using the story editor

Writing and formatting stories on Medium is super simple—just select the text you want to format and choose the relevant option from the toolbar. Below you'll find all the formatting options offered by the editor on your platform.

Basic formatting

Web App
  • Bold
    Select the text you want to format to open the text toolbar and click the B button to apply the formatting.
  • Italics
    Select the text you want to format to open the text toolbar and click the i button to apply the formatting.
  • Links
    To create a hyperlink in your post, select the text you want to convert into a link to open the text toolbar, click on the chain icon 🔗 in the toolbar to hyperlink the selected text, paste or type in a link (e.g.,, and press Enter.

Images and embeds

Learn more about adding images and embeds in the articles linked below:

Headers, subheaders, kicker

Web App

The T icons are used for formatting titles, subtitles, headers, and subheaders, depending on where the text is in the story.

Select the text and click the large or small T icon from the pop-up menu. Click it again to remove formatting.

Example of how to add a title, subtitle and kicker

  • Headers: Select the text and click the large T icon. If this is the first line of the story, the header will convert into the story's title line.
  • Subheaders: Select the text and click the small T icon. If the subheader is located below the title, it will convert into your story's subtitle.
  • Kicker: Select the text and click the small T icon. Can be set only above the title line.

Quote blocks

Web App

Select the text and click the " (quotation mark) icon from pop-up menu. To use a large or pull-out quote style, select the text and click " icon twice from pop-up menu. You can also remove quote formatting by selecting the text and clicking the " icon until text returns to default.


Web App

Simple bulleted and numbered lists in posts are also supported on Medium.

  • To begin a bulleted list, go to a new line, type in * (asterisk), and press Space.
  • To begin a numbered list, go to a new line, type in 1. (numeral one, period), and press Space.

For either type, pressing Enter at the end of a line will begin another item. Press Enter again to escape list formatting.

Note: Numbered lists cannot be continued after a section break, or between images.

Code blocks & inline code

Web App
  1. On your story, go to a new line and click the  button on the left to expand the menu.
  2. Click the “{ }” button to insert a new code block.

Example of how to add a code block through the menu

You can also create a code block by going to a new line and typing ``` (triple backtick).

Example of how to add a code block by typing

For inline code in a paragraph, type a single backtick ` to begin and end your code. You can also highlight some text and press the backtick key.

Please note: Existing code blocks in stories that have already been published on Medium prior to introducing syntax highlighting will not be automatically updated, just in case they’re being used for something other than code.

If you’d like to update an old code block in a published story, you can edit the story, create a new code block, and paste the old block’s contents into it.


To mention another Medium user in a post, type the @ symbol and then the name or username of the person you want to mention. Click their name from the drop-menu and their name will be added in green text. Any mentioned users will be notified in-product and by email (if applicable) when the story is published.



To add an emoji to your post, type in a colon, followed by the name of your favorite emoji. Check out the emoji cheat sheet to find the names of all the supported emoji.



Currently Medium supports superscript for numbers only. To output a number, such as: 6⁷ or title⁸, type in: 6^7 or title^8.

Drop caps


To add drop caps, select a paragraph and click on the drop caps icon in the menu bar that pops up.


About custom drop caps

You can also upload a custom image drop cap instead. Here's how:

  1. Follow the steps above.
  2. Click on the drop cap letter itself until a green border appears.
  3. From your desktop, drag the custom image file you'd like to use in place of your drop cap directly onto the green box.
  4. Your custom image will now appear in its place.

TK reminders


TK is a publishing abbreviation used as a placeholder in editing to mark information not yet included in a document, which is "to come."

To leave yourself a reminder, simply type TK anywhere in the body of your post. A reminder in yellow will appear left margin.

Story word count


Select a passage with your cursor to see the number of words it has in the top-left corner of your page. Select the entire story to check the word count for it.

Common questions

How can I make a single-spaced line break?

To make a single-spaced line break (as in poetry) go the end of your line and press Shift + Enter at the same time. This is available only on desktop.

How can I add a footnote?
Footnotes are not supported on Medium, but you can still use superscript and manually add your footnotes at the bottom of your story.
How can I write math on Medium?
Medium does not natively support writing mathematic expressions, but one of our users has put together a guide on using Unicode characters for maths on Medium.
Was this article helpful?