How to read Markdown privately and offline

A .md file is plain text on your device, so reading it privately means choosing tools that do not send it anywhere. The file leaves your phone only when something you use copies it elsewhere. This guide explains where that can happen, how to check an app on Android, and what to look for in an offline reader.

New to the format? Start with what a .md file is.

What can leave my device with an online converter?

An online converter is a website that turns Markdown into a page or a PDF. Many of them need your text on their server to do the work, so when you paste or upload a file, a copy may leave your phone. Some do the work inside your browser instead, and from the outside you usually cannot tell which kind you have.

What happens to that copy depends on the service. It may be deleted at once, stored for a while, or kept in logs. If you must use one, read its privacy policy first and ask yourself whether the file holds anything you would not post in public, such as names, passwords, client details or unpublished work.

What can leave my device with a synced folder?

A synced folder is one that an app keeps copied to the cloud and to your other devices. If your Markdown file sits in one, that folder's own app sends the file to its service. A reader without internet access cannot stop another app from syncing the file.

So look at where the file lives as well as what opens it. A file stored only on the phone is not touched by a cloud folder's app. If you want a private copy of a synced file, save it to a folder on the phone that is not synced.

Can opening a file contact the internet?

It can. Markdown can point to pictures on the web, and a reader that loads them asks that web server for the picture. That request tells the server your network address and that the picture was requested.

Links are the other case. Tapping a link usually hands the address to your browser, and from then on the visit is the browser's and the website's business.

How do I check an app's permissions on Android?

Google's Android Help gives these steps. Menu names can vary from phone to phone:

  1. Open the Settings app.
  2. Tap Apps.
  3. Tap the app. If you cannot find it, tap See all apps first.
  4. Tap Permissions.

This screen tells you about things like files, camera and microphone. A reader needs little of this to show a file you chose yourself. Be careful with one conclusion, though: Google's list of permission types on that help page has no entry for internet access, so do not treat this screen as the answer to whether an app can go online.

For that question, there are three more places to look:

What should I look for in an offline reader?

How does PilcrowMD handle this?

PilcrowMD is our free Markdown reader for Android, and the Android app has no internet permission since version 1.0.15. The app itself cannot send anything over the internet. It has no ads, no account and no tracking, and its source code is open (GPL-3.0).

Tables, code and maths are drawn on the phone, and so are Mermaid diagrams, offline. Web pictures are never downloaded, and links open only when you tap them. Tapping one hands it to another app, such as your browser.

There is a limit to all this. If a file sits in a synced folder, that folder's own app may sync the file, and PilcrowMD cannot change that. The details are in the privacy policy.

For more, see how to read a GitHub README on Android and how to edit an .md file on Android.

Also on Mac: PilcrowMD for Mac (beta)