Google Docs is getting Markdown support for headings, formatting, and more

There are a few gotchas though.
Illustration by Alex Castro / The Verge

Google is adding Markdown support to Google Docs on the web, letting you format your document using text shortcuts rather than keyboard ones. In a blog post announcing the feature, Google says it’s doing this through its autocorrect feature, so it will automatically format the text for you after you type it in Markdown format. For example, if you type “# Google Docs is getting more Markdown support” it’ll automatically get converted to a level one heading.

Google says that Docs already supported a few Markdown autocorrections for bulleted and numbered lists, and checkboxes. It’s adding much wider support, though — you can now use Markdown to add headings, bold and italicize text (or do both), strikethrough (though it’s done using a – on either side of your content, rather than the traditional ~), and links. That’s a far from complete implementation of Markdown, but at least it covers most of what I personally use the language for.

A new option has appeared!

To activate the feature, go to Tools > Preferences, and check the “Automatically detect Markdown” box. If you don’t see it, it may not be rolled out for your account yet — Google says it could take “longer than 15 days” for the feature to show up for everyone (personally, I had to try three different Google accounts before I found one that had it).

If you’re used to writing in Markdown in other applications, Google Docs’ implementation is probably going to take some getting used to (even ignoring the seemingly non-standard strikethrough syntax and absent options). Rather than showing you your marks in plain text, it uses them to automatically apply formatting and then gets rid of them. That’s different from how most other text editors display Markdown by default — usually, you’ll still be able to see the marks, with the editor also adding some type of formatting to give you an idea of how it’ll look when you publish.

A look at the various ways you can display Markdown — clockwise from top left: with no marks in Google Docs, with marks and formatting in iA Writer, showing marks for the line being edited and formatting everywhere else in Obsidian, and with marks and no formatting in TextEdit.

Whether you like this approach or not is probably a personal preference. Google’s implementation probably won’t appeal very much to the people who use Markdown to get complete control of their text (without having to bother with HTML’s annoying closing tags). But for anyone who just wants the ability to use Markdown as a shortcut to formatting, and doesn’t care about fussing around with plaintext, Google’s way could be relatively approachable — instead of selecting text and pressing Command / Control + L to insert a link, you can just type a few brackets and parentheses.

(It’s also probably worth noting that this implementation is much friendlier for when you share a document with a coworker who doesn’t know what Markdown is.)

Google says the feature is off by default — probably a good choice, as it’s easy to imagine a lot of people getting confused if typing a pound sign in front of something automatically switched it to be a header — and that it’s coming to “Google Workspace customers, as well as legacy G Suite Basic and Business customer,” alongside personal accounts. Now if you’ll excuse me, I think it’s time to start a campaign to get Google to add a Vim mode to Docs, since it’s getting into the habit of adding fun nerdy features.

Leave a Reply

Your email address will not be published. Required fields are marked *