Google Docs Markdown: edit .md files natively

Google Docs and Drive now handle Markdown files natively

Google Docs now edits .md and .markdown files in place instead of turning them into Docs files first. Until this update, opening one meant importing it as a Doc, and Google says that step tended to change the formatting, lose comments and leave copies scattered around. Google ties the change to AI work, since Markdown is the plain-text format large language models lean on to keep headings, lists and tables intact.

Open and edit md files in Google Docs without converting

Double-click an .md file in Drive and it opens in Google Docs as the same .md file. Docs switches to what Google calls Markdown Mode and puts an .md tag beside the document title, so it is clear which kind of file is open. Nothing is saved as a Google Docs file along the way.

Editing works as it does in any other Doc, and you can apply headings or bold without typing the symbols yourself. Comments, sharing and several people editing at once all carry over, and Google says comments and formatting are still there when the file is reopened in Docs or another tool. Google also pitches the format for teams where people and AI agents work on the same file.

Google Drive previews Markdown with tables and links

Drive can now display an .md file with its formatting applied rather than as raw symbols. Right-click the file, choose Open with, then Preview, and the viewer renders tables and makes links clickable. A switch at the top flips between the formatted view and the raw Markdown.

The preview is read-only. To change anything, open the file in Google Docs.

Native Markdown support reaches all accounts within 15 days

The rollout began on October 5, 2026, and Google allows up to 15 days for it to show up everywhere. Because accounts receive it in stages, a colleague may see it days before you do.

The md file feature rolls out within 15 days

Personal Google accounts get it with no setting to turn on

Personal Google accounts are covered, along with every Google Workspace customer. A work or school account is not required to use it.

Google lists no setting for users and no control for admins. An organization cannot hold the feature back, and an individual has nothing to enable once it lands.

Google Docs formatting that Markdown files drop

Anything Markdown has no syntax for is lost once you edit and save the file as .md. An .md file is plain text plus a few symbols, so styling that exists only inside Docs has nowhere to be stored.

Smart chips become text and font colors are removed

Google's help page says smart chips are turned into plain text or links. HTML formatting pasted from the web becomes plain text, and font colors, highlights and text alignment such as centering are removed outright.

A document that relies on colored text for emphasis will lose that emphasis on save. Headings, bold and other formatting that Markdown can express stay as they are.

Tables and images may not convert cleanly in md files

Google does not document this, but the Japanese tech site gihyo.jp tested it on October 6 and reported limits. In that test, Docs could not handle Markdown containing a table without a header row or a description list (terms paired with definitions).

Images behaved differently too. Where an image had been placed, only a link remained, and the image itself was appended to the end of the file as Base64, an encoding that writes the picture out as a long run of text. A document with many images therefore ends in a very long block of characters.

Restore lost formatting from version history

Restoring an earlier version brings the dropped formatting back. Google's help page points to version history for this. Pick the last version saved before the .md edit and restore it.

2024 import, export and paste options still convert to Docs

The 2024 tools move content between Markdown and the Docs format, while the new feature never leaves Markdown. On July 16, 2024, Docs gained four options: converting pasted Markdown, copying Docs content as Markdown, downloading a Doc as .md and importing an .md file as a Doc. Every one of them converts, which is the step this update removes.

Paste from Markdown and copy as Markdown need a preference

The Markdown paste and copy options only appear after you turn on the Enable Markdown preference. Once that box is checked, "Paste from Markdown" and "Copy as Markdown" become available.

Import and export work out of the box. You can download a Doc as .md or open an .md file as a Doc without changing any setting.

Convert a Word file to Markdown before upload

The update does not cover Word documents (.docx), so convert one to Markdown first if you want to edit it this way. The new editing applies only to files ending in .md or .markdown.

The sakutto Word to Markdown converter turns a .docx into Markdown while keeping headings, tables and lists. It runs in your browser, so the file is not uploaded anywhere. If the result is headed for a web page or an email, the Markdown to HTML converter produces the HTML.

Edit .md files in Docs instead of converting them

Google Docs Markdown support has moved from converting .md files to editing them directly. The rollout started on October 5, 2026, covers personal accounts and needs no setting. Colors and highlights do not survive in an .md file and smart chips turn into text, so documents that depend on them are best kept as regular Docs.