Google Docs features built-in support for Markdown syntax, allowing users to apply formatting shortcuts on the fly. For instance, enclosing a word in asterisks (such as *example*) automatically converts it into italic text, typing double asterisks (**example**) renders bold text, and typing a hash followed by a space (# Heading) transforms the line into a top-level heading. While this auto-formatting is convenient for developers and markdown enthusiasts who draft web copy, it creates persistent headaches for technical writers, programmers, teachers, and editors. When writing mathematical expressions, shell commands, literal code snippets, or notes containing wildcards, Google Docs constantly intercepts typed characters, stripping literal punctuation and converting text without permission. Here is how to stop Google Docs from automatically converting Markdown formatting.
Why Disable Automatic Markdown Detection in Google Docs?
Turning off automatic Markdown conversion restores predictable word processing behaviour across your documents:
- Preserve Literal Code and Punctuation: Allows you to type asterisks, underscores, backticks, and hash symbols freely without unwanted styling conversions.
- Avoid Formatting Jumps: Prevents sudden font size jumps and heading reformats when creating numbered lists or typing hashtag labels.
- Streamlined Technical Documentation: Essential for software documentation, terminal command references, and legal drafting where raw punctuation must remain intact.
- Account-Wide Preference: Toggling the preference applies across all your Google Docs documents on your Google account.
Step-by-Step: Turn Off Markdown Detection in Google Docs
You can disable automatic Markdown conversion through the application’s Preferences dialogue:
- Open any document in Google Docs on your desktop web browser.
- Click on the Tools menu in the top toolbar.
- Select Preferences from the drop-down menu.
- In the Preferences dialogue box, remain on the General tab.
- Locate the option labelled Automatically detect Markdown.
- Untick the checkbox beside Automatically detect Markdown.
- Click OK to confirm and save your preferences.
Google Docs will now treat all asterisks, hashes, backticks, and brackets strictly as plain text characters, leaving your typed syntax completely unaltered.
Supported Markdown Shortcuts That Are Disabled
Unticking the setting deactivates the following automatic formatting substitutions:
- Headings: Typing
#,##, or###followed by a space will no longer alter line styles. - Italic and Bold Text: Surrounding words with
*single*or**double**asterisks remains literal. - Strikethrough: Words wrapped in tildes (
~text~) will not be formatted with strikethrough. - Inline Links: Brackets and parentheses (
[link text](url)) will not automatically convert into clickable web links.
Comparison: Markdown Detection Enabled vs Disabled
| User Input | Markdown Detection Enabled (Default) | Markdown Detection Disabled (Recommended) |
|---|---|---|
| **bold text** | Converts to bold text; asterisks removed | Remains **bold text** literally |
| *italic text* | Converts to italic; asterisks removed | Remains *italic text* literally |
| # Main Title | Transforms paragraph into Heading 1 | Remains plain text starting with # symbol |
| `code snippet` | Converts into monospace inline block | Remains plain text with literal backticks |
Quick Undo When You Need Occasional Markdown Conversions
If you prefer keeping Markdown detection enabled for general writing but want to cancel a specific auto-conversion immediately:
- Instant Undo Shortcut: The second Google Docs converts your syntax (for instance, turning
*item*into italics), immediately press Ctrl + Z (or Cmd + Z on Mac). The formatting will revert, leaving your literal asterisks on the page.