MD Reader

How to open a .md file on Android

Updated:

A .md file is a markdown document: plain text with a few symbols (#, **, -) that describe headings, bold text and lists. Android doesn't ship with an app that understands those symbols. So when you tap a .md file, you usually get one of three results:

To read it as a formatted document, you need a markdown viewer.

Step 1: Install a markdown viewer

Install a markdown viewer from Google Play. In this guide we use MD Reader, which is free, works offline and doesn't request internet access.

Get it on Google Play

Step 2: Open the file

You can open the file from wherever it is.

From the Files app or Downloads

  1. Open Files (or My Files on Samsung) and find the .md file.
  2. Tap it. If Android asks which app to use, choose MD Reader.
  3. Tap Always if you want .md files to open in it every time.

From inside the app

  1. Open MD Reader.
  2. Tap Open file.
  3. Pick the file in the Android file picker. You can browse Downloads, internal storage and cloud apps like Google Drive from there.

From another app

If an app can share a file or text, tap Share and choose MD Reader. This works for many cloud storage, chat and note apps.

Step 3: Read, search and edit

Once the file is open you'll see headings, tables, code blocks, links and checklists rendered properly. You can:

If the file still won't open

New to markdown? Read what a .md file is first. It takes two minutes.