How to open a .md file in Chrome.

Chrome shows Markdown files as plain text. Install the free Markside extension, turn on Allow access to file URLs, then drag the .md file into Chrome. It opens as a formatted document you can read and edit.

Three steps, about a minute.

Works the same on Windows, Mac, Linux, and ChromeOS.

  1. Install Markside.

    Add the free Markside extension to Chrome.

    Open the Chrome Web Store
  2. Allow access to file URLs.

    Open chrome://extensions, choose Details under Markside, and turn on Allow access to file URLs. Chrome turns this off for every extension by default.

  3. Open the .md file in Chrome.

    Drag the file into a Chrome window, or press Ctrl+O (Cmd+O on Mac) and pick it. It opens as a formatted document instead of plain text.

Make Chrome open every .md file.

Set Chrome as the default app once, then double-click any Markdown file to read it.

  • Windows

    Right-click any .md file, choose Open with → Choose another app, select Google Chrome, and click Always.

  • Mac

    Select a .md file in Finder, press Cmd+I, set Open with to Google Chrome, and click Change All.

  • Linux

    In your file manager, open the file’s Properties → Open With, choose Google Chrome, and set it as default.

What you get.

  • Headings, tables, task lists, footnotes, and alerts
  • Math, Mermaid diagrams, and Vega-Lite charts
  • Highlighted code blocks with copy buttons
  • An outline for long documents and a file tree for folders
  • Edit and save back to the same file with Ctrl+S
  • Light and dark themes

Questions.

What is a .md file?
A Markdown file: plain text with simple formatting marks, like # for headings and ** for bold. README files, notes apps, ChatGPT and Claude exports, and AI coding agents all produce them.
Why does Chrome show my .md file as plain text?
Chrome has no built-in Markdown renderer, so it shows the raw text with all the formatting marks. A Markdown viewer extension renders it as a formatted page.
Can I open a .md file without installing anything?
Any text editor, such as Notepad or TextEdit, opens it, but you see the raw marks. To read it formatted, you need a Markdown app or a browser extension like Markside.
Is Markside free? Do my files leave my computer?
Markside is free and open source under the MIT license. Files are read and rendered in your browser. There is no account and no analytics, and nothing is uploaded unless you choose to share a document.
Can I edit the file too?
Yes. Switch to Source or Split view, edit, and press Ctrl+S (Cmd+S on Mac) to save to the original file.
Which file types work?
.md, .markdown, and .mdx render as documents. Other text files in an opened folder open in the editor, and images open in an image viewer.