What Is an MD File? How to Open, View, and Convert It

An .md file is a plain-text document written in Markdown. The source stays readable in any text editor, while a Markdown viewer turns its markup into headings, lists, tables and links.

Last updated: November 19, 2026

Have an MD file to inspect?

Open it in the Markdown viewer to see the formatted result without installing anything. The source file is read in your browser and is not uploaded.

What an MD file actually is

A text file whose markup describes structure, not visual styling.

The .md extension marks a file written in Markdown, a lightweight markup language. Markdown was created by John Gruber in 2004, and the later CommonMark specification made the core syntax unambiguous. GitHub-Flavored Markdown adds extensions such as tables, task lists and autolinks. The Markdown reference at Wikipedia summarizes the format's history and variants.

markdown
# Project notes

- [x] Draft the outline
- [ ] Review with the team

| Format | Editable |
| :--- | :--- |
| `.md` source | Yes |
| `.docx` export | Yes |

The same text is readable as plain text and becomes formatted when a Markdown viewer renders it. The heading becomes a heading, the checklist becomes task boxes, and the pipe table becomes a real table.

Where you commonly find .md files

The extension is a convention, so the same format shows up in many tools.
  • README and documentation files in software projects.
  • Documentation sites, wikis and static-site generators.
  • Notes, knowledge bases and personal plain-text archives.
  • Issue, pull-request and chat content that accepts Markdown.

How to open an MD file

You can read the source anywhere; a viewer adds the formatted result.

In a text editor

Any editor that handles plain text can open an .md file. You will see the characters exactly as written, including # for headings and pipes for tables. That is useful for edits and version control, but it is not the final formatted page.

In a Markdown viewer online

The homepage viewer lets you paste Markdown, open a local file or drop one into the workspace. The preview updates as you type. Local files can be up to 150 KB, and the preview/export pipeline is limited to 120,000 characters. Raw HTML is stripped, and Mermaid diagrams and syntax highlighting are not supported.

How to preview Markdown online

A short workflow for checking an MD file before you share or convert it.
  1. Open the Markdown viewer.
  2. Paste your Markdown or open the .md file from your device.
  3. Check headings, tables, task lists, links and equations in the preview.
  4. Copy the source or formatted HTML, or continue to a conversion route below. The cheat sheet helps if a syntax pattern is unfamiliar.

Common conversions

An MD file is usually an intermediate source, not the final delivery format.

MD to Word (.docx)

The Markdown to Word converter produces an editable Word document from the Markdown already in the browser. Tables and supported equations are written as Word structures. Remote images are not embedded, DOCX export is limited to 500 equations and a 25 MB output file, and layout can vary between Word versions. For repeatable conversion, see the Python or Pandoc command-line guides.

MD to PDF

The Markdown to PDF page uses your browser's print dialog rather than a separate rendering engine. Check the preview first because page size, margins and fonts come from the browser and printer settings.

MD to HTML

After previewing, copy the sanitized formatted HTML. This is not a separate download route; it is the rendered version of the Markdown currently in the viewer, with raw HTML removed and link schemes restricted.

Advantages and limitations of Markdown

Useful for source text, with clear boundaries around presentation.

Markdown is readable without special software, easy to version and diff as text, and portable across many editors and publishers. It does not define exact page layout, fonts or print styling, and dialects differ: a construct supported by GFM may not work in another parser. This viewer follows CommonMark and GFM for the features it documents, and it deliberately omits raw HTML, Mermaid diagrams and syntax highlighting. The limits above are stated in the help guide as well.

MD vs .markdown vs .txt

Three names you may see for similar-looking text files.
  • .md — the common short extension for a Markdown document.
  • .markdown — a longer, equally valid extension; this viewer accepts it too.
  • .txt — generic plain text. It may still contain Markdown, but the extension alone does not signal that a viewer should render it.

FAQ

Short answers about opening, viewing and converting MD files.
Can I open an .md file in Microsoft Word?
You can open the raw text, but Word will not apply Markdown formatting automatically. To get headings, paragraphs, tables and supported equations as Word structures, use the Markdown to Word converter.
Is .md just a .txt file with a different name?
Both contain plain text, but the .md extension signals that the text uses Markdown markup. A text editor shows the markup as written; a Markdown viewer interprets it and displays formatted content.
Should I use .md or .markdown?
Both extensions are used. .md is the common short form, and this site's viewer accepts local .md and .markdown files. Use whichever your tools and team already expect.
Do I need to upload my file to preview it online?
No. The homepage viewer reads local files in your browser. There is no document upload endpoint, and the source stays in in-memory app state while you move between tools on this site.
Can I get HTML from an MD file?
Yes. After previewing, copy the sanitized formatted HTML from the viewer. Raw HTML in the source is removed before rendering, and links are limited to http, https and mailto.
Does the viewer support Mermaid diagrams or code highlighting?
No. Mermaid diagrams and syntax highlighting are not supported; code is displayed as plain monospaced text. The Markdown cheat sheet lists the syntax that is supported.

Keep exploring