Most Linux file managers cannot render Markdown, so a .md file usually opens as plain text with # and ** symbols still in it. There are good options, though: desktop apps with a live preview, editors you may already use, tools that render Markdown inside the terminal, and a browser tool that needs no install. This guide helps you pick one.
The short answer
- Read a file once: open or drop it into the online Markdown viewer. Nothing is installed and the file is not uploaded.
- Write Markdown regularly: Ghostwriter, Apostrophe or Zettlr.
- Already use a code editor: the built-in preview in VS Code. See Markdown preview in VS Code.
- Work over SSH or in a terminal: Glow or mdcat. See Markdown in the terminal.
Desktop apps for Linux
Ghostwriter
A distraction-free Markdown editor from the KDE community with live preview and themes. It can export through Pandoc when Pandoc is installed. It is packaged by many distributions and is available as a Flatpak.
Apostrophe
A clean GNOME-style writing app with live preview, distributed on Flathub.
Zettlr
An open-source editor aimed at research and note-taking, with citation support, a file library and Pandoc-based export. Downloads are offered as AppImage, .deb and .rpm packages.
MarkText
An open-source editor that renders as you type instead of using a split view. Before you choose it, look at the project page for recent releases, because development activity has varied over time.
Obsidian
A notes app built around folders of Markdown files and links between notes. It is closed source and is offered as AppImage, Flatpak and Snap.
Typora
A polished single-pane editor with Linux builds. It is proprietary and paid after the trial period.
Read Markdown in a browser
Firefox and Chrome show a raw .md file as plain text. You can paste or open it in the online viewer, or install an extension that renders local files. The Chrome extension guide explains the setup and the one setting you have to switch on.
Convert a file with Pandoc
If you only want to read one file in your browser, Pandoc can turn it into HTML:
pandoc README.md -o README.html
xdg-open README.html
Which one should you pick?
| You want to | Use | Install needed |
|---|---|---|
| Open one file quickly | Online viewer | No |
| Write notes every day | Ghostwriter, Zettlr or Obsidian | Yes |
| Edit code and docs together | VS Code | Yes |
| Read files over SSH | Glow or mdcat | Yes, a small command-line tool |
Questions
Can my Linux file manager preview Markdown?
Not out of the box on most desktops. Some environments offer thumbnailers or plugins, but an app, a terminal tool or the online viewer is more predictable.
Does the online viewer work offline?
The page has to load first. After that the Markdown is rendered inside your browser. For fully offline use, pick one of the desktop apps above.
Want to see how a file looks right now? Open the Markdown viewer.
Markdown Viewer Chrome Extension: Setup and Alternatives
Markdown in the Terminal: Glow, mdcat and More
Preview Markdown in VS Code: Shortcuts and Extensions
Best Markdown Editors: Online, Desktop and Code