A Markdown viewer for Mac, Windows, Linux, iPhone and Android

Markdly is a Markdown editor built for reading .md files where they are, on a computer and on a phone, and fixing a line without switching apps. It runs on Mac, Windows, Linux, iPhone, iPad and Android, and draws diagrams and math with no connection. Its Visual view, the formatted page, also edits: there's no read-only mode. It's paid, with a sign-in.

  • Three views: Visual for the formatted page, Markdown for the text, Split for both.
  • Your file, in place: save, and your edits go into the same .md file.
  • More than .md: it also opens .markdown and plain .txt files.

$19.99 once, no subscription.

Ways to view a Markdown file

  • Free

    VS Code's Markdown preview

    Cost
    Free
    Good for
    A formatted view on a Windows, Mac or Linux computer. Press Ctrl+Shift+V (⇧⌘V on a Mac), or Ctrl+K V (⌘K V) to put the preview beside the text.
    The catch
    It's a code editor, so reading a note means opening a programming tool. Microsoft says the preview's default security setting disables scripts and blocks images loaded over http.

    Visual Studio Code docs: Markdown and Visual Studio Code

  • Free

    GitHub

    Cost
    Free
    Good for
    A file that's already in a repository: open it on GitHub and it's shown formatted, diagrams and math included.
    The catch
    Only for files on GitHub, so the file has to be uploaded there first and you need a connection to read it.

    GitHub Docs: Creating diagrams

  • Free

    Dillinger

    Cost
    Free
    Good for
    Pasting Markdown into a web page and seeing it formatted beside the text. You can start typing without registering, and Dillinger says the editor keeps working after it has loaded, even with the network gone.
    The catch
    It's an editor on a website, not an app on your device: you paste the text in, or load it from a service you connect, such as GitHub or Dropbox. Drafts are kept by your browser, in its local storage.

    Dillinger: Online Markdown Editor with Live Preview

  • Our app

    Markdly

    Cost
    $19.99 once, or every premium Bravely utility for $95.99/yr or $399 once
    Good for
    Reading .md files where they are, on a computer and on a phone, and fixing a line without switching apps.
    The catch
    It's paid, with a sign-in, and it's a full editor: more than you need if you only ever read.

How to view a Markdown file in Markdly

  1. Get Markdly and sign in

    Download Markdly for Mac, Windows or Linux, or get it from the App Store or Google Play. Sign in with your Bravely Account.

  2. Open the file

    On a Mac, right-click the .md file and choose Open With, then Markdly. On Windows 11 it's Open with. On an iPhone or iPad, the Files preview of a .md file has a button for Markdly under it. On Android, open Markdly first and pick the file.

  3. Choose Visual

    The three views are at the top of the window on a computer and at the top of the document on a phone. Pick Visual for the formatted page: headings, tables, task lists, diagrams and math, drawn. On a Mac the key is ⌘1.

  4. Fix something in place

    Type straight into Visual. Or switch to Markdown for the text, or to Split for both at once: side by side on a computer, an iPad or an Android tablet, stacked on a phone. On a Mac, ⌘2 and ⌘3 switch to them, and ⌘\ steps through all three.

    On a Mac or a Windows PC, save when you're done, with ⌘S or Ctrl+S. The file on disk doesn't change until you do.

What a good Markdown reader shows

Headings and bold are the easy part. These six checks separate the tools, and you can hold any of them to the list.

  • Tables and task lists, drawn as a grid and as checkboxes.
  • Diagrams and math: a Mermaid code block as its diagram, and LaTeX math typeset.
  • No connection needed, so a file opens on a plane.
  • The file where it is: no upload, no import, no second copy to keep track of.
  • Your phone too, since that's where a .md attachment often turns up.
  • A way to change a line without opening another app.

A website or an installed app

An online viewer is the quickest thing to try: nothing to install, and a formatted page in seconds. The cost is that the text has to get to the page. You paste it or connect a service, and with Dillinger what you paste is then kept in that browser's local storage. For a private document, read the site's privacy terms first.

An installed app starts from the file. In Markdly you open the .md from your file manager and it's the same file on disk afterwards: plain text that any other tool still reads. The engines that draw diagrams and math are inside the app, so the page looks the same with the network off.

If all you want is to get one file open right now, What an MD file is and how to open one has what's already on a Mac, a Windows 11 PC and a phone, and the steps for making an app the default.

Reading Markdown on a phone

Markdly's iPhone, iPad and Android apps open the same files the computer apps do, and Visual draws the tables, the task boxes, the diagrams and the math there too.

One purchase covers the phone and the computer: sign in with the same Bravely Account and Markdly is unlocked on each.

What Markdly doesn't do as a viewer

  • It has no read-only mode. Visual, Markdown and Split all edit.
  • It isn't a website. You install it on each device, and you sign in with a Bravely Account on each one, which needs a connection.
  • On an iPhone and on Android, one document is open at a time.
  • The Windows and Linux apps are for 64-bit Intel and AMD (x64) PCs only.

FAQs

What should I use to view a Markdown file?

For a file now and then on a computer, VS Code's preview or GitHub is enough, and both are free. If .md files reach you often, or on your phone, an app that opens the file itself saves the pasting. Markdly is one, on Mac, Windows, Linux, iPhone, iPad and Android.

Is there a free way to view Markdown files?

Yes. VS Code's Markdown preview, GitHub and the online editor Dillinger are all free. Markdly is paid.

Can I view a Markdown file online?

Yes. Paste it into an online editor such as Dillinger, which shows the formatted page beside the text, or open the file on GitHub if it's in a repository.

How do I view a Markdown file on my phone?

Use an app that formats Markdown. Markdly runs on iPhone, iPad and Android and shows the formatted page in its Visual view. How to open MD files on each device

Do Markdown readers show Mermaid diagrams and math?

Some do. Microsoft says VS Code's built-in preview renders Mermaid diagrams and uses KaTeX for math. GitHub's docs say it draws diagrams in Markdown files and typesets math with MathJax. Markdly draws both in Visual.

Can I edit a Markdown file while I'm viewing it?

In Markdly, yes: type straight into Visual, then save, and the change goes into the .md file. In VS Code the preview is for reading, and you edit in the text beside it.

Markdly icon

Markdly

Native markdown editor

$19.99 once, no subscription.