To read a Markdown file like a normal document, open it in a markdown viewer online. Drop your .md file into our free document viewer and it appears as tidy A4 pages with a contents list. Nothing is uploaded and there's no sign-up.

What is a Markdown file, in plain English?

Markdown is ordinary text with a few small marks that say how it should look. A hash at the start of a line means a heading. Two stars either side of a word mean bold. A dash at the start of a line means a bullet point.

So the file itself might look like this:

```

Staff holiday policy

Please book leave two weeks ahead.

• Ask your manager
• Add it to the calendar
  ```

A viewer reads those marks and shows you the finished result: a proper heading, a bold phrase and two neat bullet points. Without one, you're looking at the instructions instead of the document. It's a bit like ordering soup and being handed the recipe.

The .md on the end of the file name simply stands for Markdown. The format has been around since 2004, which in software years makes it a respected elder. It has outlasted plenty of grander formats because it's only text. Any computer can open it, and nothing about it breaks when the next version of something comes out.

The catch is that "open" and "read comfortably" are different things.

Why do people keep sending me .md files?

Mostly because of two groups: developers and AI tools.

Developers write notes in Markdown because it sits happily next to their code and they can type it without reaching for a mouse. The instructions for a software project usually live in a file called README.md. So if you've had something built, the handover notes may well land in your inbox in this format. Nobody is being awkward. To a developer this is a normal document, in the same way that a plumber sees nothing odd about keeping a length of copper pipe on the back seat.

AI tools are the newer source. ChatGPT, Claude and the rest tend to write in Markdown as a matter of habit. That's why text copied out of a chat window sometimes arrives full of stray stars and hashes, as though a cat with firm views on formatting had crossed the keyboard. Ask one of these tools for a report as a file, and you may well be handed an .md.

The contents are often perfectly ordinary business documents: a policy, a proposal, a set of meeting notes. They just come dressed for the workshop instead of the office.

How do I open a Markdown file without installing anything?

Double-click an .md file on most computers and one of two things happens. It opens as raw text with every hash and star on show, or the computer politely asks which app you'd like to use, knowing full well you have no idea.

To view a Markdown file properly, use the browser instead:

1. Go to our free document viewer.
2. Drop your file onto the page, pick it from your device, or paste the text in. Plain .txt files work as well.
3. Read it.

That really is the whole process. Your file appears as A4 pages, the way a document ought to look, with a contents list so a long file has a way in. There's no account to create and nobody asks for your email address.

It also works on phones. A4 pages would be a misery on a screen that size, so the text flows into one column instead. If someone sends you an .md on WhatsApp while you're out, you can open the md file online and read it there and then.

Can I edit the file and save it as a PDF?

Yes to both.

The Markdown tab shows you the raw text, stars and all. Change something there and the pages update live as you type, so you can see exactly what your edit has done. This is handy when an AI draft is nearly right but has given your business the wrong name in the second paragraph, as they sometimes will. When you're happy, save it as an .md file.

Getting from md to pdf is just as short. Use the print option, then choose Save as PDF in your browser's print window. Or print it on real paper, if you have a printer that's in a good mood. Either way you end up with something you can send to a client, or a board, without having to explain what a hash is for.

Can I convert Markdown to Word?

Yes. Open the file, choose Save, then Word (.docx). Headings, lists, tables and links all come across, so you get a proper Word document rather than a wall of stars and hashes.

You can also skip the Markdown altogether. The Edit tab lets you type straight onto the page, the way you would in Word, with a toolbar for bold, headings, lists, tables and links. Behind the scenes it's still kept as Markdown, so whoever sent you the file gets back the format they expect, and nobody has to know you never looked at a hash.

Next on the list is opening Excel files, so a spreadsheet can get the same treatment.

Is it safe to open a private document in an online viewer?

Any time you use a free online tool, it's fair to ask where your file goes. With ours, the answer is nowhere. It all runs in your browser, on your own device, and nothing is uploaded to us.

That matters when the document is a contract, a staff matter or a quote you haven't sent yet. We couldn't read your holiday policy if we wanted to, and I promise we have other hobbies.

Why is a website company giving this away?

Because Markdown files pass through our work all the time, and they keep turning up in the hands of people who never asked for one. Opening a document shouldn't need a developer. This is a small problem with a small fix, so we built the fix and put it where anyone can use it.

It's free and it isn't a trial. There's no countdown, and the Save button won't turn out to be a subscription in disguise. We build websites and business systems for a living, and if the viewer saves you ten minutes of squinting at hashes, you might remember us when your website needs some attention. That's the whole scheme.

If that day comes, we've written plainly about what a site costs for a UK small business and for a small business in Malawi.

Quick answers

What's the easiest way to view a Markdown file?

Drop it into a markdown viewer online, such as our document viewer. It shows the file as A4 pages with a contents list.

Can I open an .md file on my phone?

Yes. The viewer works on phones and flows the text into a single column, so it's easy to read on a small screen.

How do I turn a Markdown file into a PDF?

Open it in the viewer, use the print option, and choose Save as PDF in your browser's print window.

Does the viewer cost anything?

No. It's free, there's no sign-up, and your file stays on your device.

Want your website to be as easy to read as your documents now are? Ask for a free website audit.