Using Markdown in Google Docs is possible without any add-on: turn on the Markdown option in Preferences, type syntax such as ## Heading or **bold**, and Docs converts it into formatted text as you type. You can also paste Markdown and download a document back as a .md file. This guide shows how each piece works and where its limits are.
Key takeaways
- Google Docs can convert Markdown shortcuts while you type once the option is enabled.
- Pasting and exporting Markdown are separate features from typing shortcuts.
- Only the common syntax is supported, so tables and code fences may need manual work.
- Menus change over time, so check the official help page if an option looks different.
What Markdown in Google Docs Actually Does
Google Docs is a rich text editor, not a plain text editor. Markdown support therefore means translation: the editor watches what you type, recognizes familiar symbols and swaps them for real formatting. The symbols disappear and a true heading, bullet or bold run takes their place.
That is handy for writers who already think in Markdown, because you never need to reach for the toolbar. If you want a refresher on the symbols themselves, keep our Markdown cheat sheet open in another tab.
How to Turn On Markdown in Google Docs
The setting lives in the preferences dialog and applies to your account, so you only do it once. Menus can change, so treat the path below as accurate at the time of writing.
- Open any Google Doc in a desktop browser.
- Click Tools in the menu bar, then choose Preferences.
- Tick the option that automatically detects Markdown.
- Click OK.
From now on, supported syntax typed at the start of a line or around a word converts when you press space or Enter. Google documents the behavior on its help page, the official Markdown help page, which is the place to check for the current list of supported syntax.

Markdown Syntax You Can Type
With detection enabled, the everyday syntax converts on the fly. Type these patterns and finish with a space or a new line:
# Heading 1
## Heading 2
### Heading 3
**bold text**
*italic text*
~~strikethrough~~
- bullet item
1. numbered item
Headings are the most useful conversion. A line that starts with ## and a space becomes a Heading 2 paragraph style, which then feeds the document outline and any table of contents. Our guide to Google Docs heading styles explains what happens next.
If a Conversion Does Not Fire
Auto-conversion only happens as you type. Text that was already in the document, or text you pasted as plain content, is left untouched. Press Ctrl+Z (Cmd+Z on a Mac) right after a conversion if you wanted the literal symbols; Docs typically reverts the formatting and leaves the characters.
Paste and Export Markdown
Typing is only one direction. Google Docs also offers ways to move whole blocks of Markdown in and out. With the Markdown option enabled, the Edit menu and right-click menu can show actions for copying as Markdown and pasting from Markdown, and the File > Download submenu can include a Markdown (.md) format. Availability can vary by account and rollout, so look for these entries rather than assuming them.
| Task | Where to look | Good for |
|---|---|---|
| Convert while typing | Tools > Preferences | Drafting in Markdown habits |
| Paste a Markdown draft | Edit or right-click menu | Moving text from a code editor |
| Copy a section as Markdown | Edit or right-click menu | Sending text to a README or CMS |
| Export a whole doc | File > Download | Version control and static sites |
For step-by-step help with a pasted draft that comes out as literal symbols, see pasting Markdown into Google Docs without messy formatting.

Limits to Know Before You Rely on It
- Not every flavor is covered. Features from extended flavors, such as footnotes or task list syntax, may not convert.
- Tables do not build from pipes. You will usually insert a table from the Insert menu instead of typing
| a | b |. - Round trips are lossy. Comments, suggestions, fonts and page layout have no Markdown equivalent, so an exported
.mdfile carries content and structure but not the look. - Images may need extra care. Check exported image references before publishing.
If your goal is a clean file for a static site or repository, our walkthrough on converting Google Docs to Markdown compares the available methods.
A Practical Workflow for Writers
A simple approach is to draft in Docs with Markdown detection on, use headings and lists as you type, then collaborate through comments and suggestions as usual. When the text is final, export or copy it as Markdown and review the result in a plain text editor. Fix anything that did not translate, such as tables, and commit or publish the file.
Frequently Asked Questions
Does this work in the mobile app?
Preferences are set from the desktop editor. Mobile behavior can differ, so test a short line in the app you use.
Why did my symbols stay visible?
Detection may be off, or the text was pasted rather than typed. Enable the option in Tools > Preferences and retype the line.
Can I turn the feature off again?
Yes. Open Tools > Preferences and clear the Markdown option.
Does it support code blocks?
Support is limited to the syntax listed on Google’s help page. Use a monospace font style for code if fences do not convert.
Will exported Markdown keep my formatting?
It keeps structure such as headings, lists, bold and links. Visual layout, fonts and comments are not part of Markdown.
Wrap-Up
Enable Markdown once in Preferences, type headings and emphasis the way you always do, and use the paste and download options when you need to move text elsewhere. Check the official help page for the latest supported syntax, since Google updates the feature over time.



