Why a .md file will not just open
A .md file is a Markdown document. It is plain text, but it uses symbols for structure: # for headings, - for list items,
**bold** for emphasis and pipes for tables. Android does not include a markdown reader, so the phone either asks you to pick an app
or shows the raw symbols in a text viewer. To see headings, tables and code laid out cleanly you need an app that renders markdown.
Markdown files turn up more often than people expect: project documentation and README files, notes exported from note apps, documents a colleague wrote in a code editor, and answers saved from AI assistants. They all end in .md or .markdown.
Open a .md file in four steps
- Install a markdown viewer. Markdown Editor: MD Viewer is free on Google Play and needs no account.
- Find the file. It may be in the Files app, in Downloads, in Google Drive, or attached to an email or chat message.
- Tap it and choose Open with. Pick Markdown Editor in the list. If Android offers "Always", choose it once and every future .md file opens there.
- Read. The document appears formatted straight away. Switch to edit mode if you want to change something.
Opening from different places
Files and Downloads
Tap the file. If you have not set a default yet, choose Open with, then Markdown Editor.
Google Drive
Open the file in Drive and use the menu to open it with another app, then choose Markdown Editor. If Drive only offers a preview, download the file first and open it from Downloads.
Gmail and chat apps
Tap the attachment, let it download, then open it with Markdown Editor from the notification or from the Downloads folder.
From inside the app
Open the app and pick a file or a whole folder from the home screen. This is handy when you keep many notes in one folder, for example a documentation directory.
What you see once it is open
- Headings, lists, task lists and links laid out as intended.
- Tables that scroll sideways or fit the screen with one tap, so wide tables stay readable.
- Code blocks with syntax highlighting.
- Math and LaTeX formulas, rendered offline.
- Right-to-left text such as Arabic or Hebrew aligned correctly next to English.
- Dark and light mode and an adjustable font size.
Editing and saving
If you change the document, the app saves back to the same file a few seconds after you stop typing and keeps a draft on your phone while you work. It also keeps the last 10 versions of each file, so you can go back. Some apps only share a read-only copy of a file; in that case use Save a copy to keep your edits in a file you can change.
If images do not show
Documents are displayed offline. To show images that the document links from the internet, turn on Settings, then Load images from the web.
Next steps
Reading markdown that came from a chatbot? See how to read markdown from AI assistants on your phone. Need to share the document with someone who has no markdown app? Read how to convert a .md file to PDF on Android.
Frequently asked questions
What is a .md file?
A .md file is a plain text document written in Markdown, a simple way of marking up headings, lists, links and code with ordinary characters such as # and *. Any text editor can open it, but a markdown viewer shows it formatted.
Can Android open a .md file without an extra app?
Often not. Many phones have no app that understands .md, so tapping the file does nothing useful or offers to open it as plain text. A markdown viewer fixes that.
Does it also open .markdown and .txt files?
Yes. Markdown Editor: MD Viewer opens .md, .markdown and .txt files.
Are my files uploaded anywhere?
No. The app has no account and no servers. Files are read from, and saved to, your phone or the storage app you opened them from.
Try it on your own files
Markdown Editor: MD Viewer is free to install, needs no account and keeps your documents on your phone.
Get it on Google Play