MD file: what it is, how to open it, how to convert it

You downloaded a file with a .md extension. Or someone sent you one. Or your AI assistant exported a conversation to one. Now what?

An MD file is a plain-text Markdown document. Any text editor on any operating system opens it. But "open" usually isn't what you want - you want to view the formatted content, edit it, or convert it to a real document. This guide covers all three.

What's actually in an MD file?

An .md file is just text. Open it in TextEdit, Notepad, or VS Code and you'll see something like:

# Meeting notes

## Action items

- Email the client by Friday
- Review pricing proposal
- **Bold something important**

> Quote from the call: "we need this by end of quarter."

The # symbols, - bullets, and ** asterisks are Markdown syntax. They turn into headings, lists, bold, and quotes when the file is rendered. The raw text is intentionally readable on its own - that's the whole point of Markdown.

The file extension might also be .markdown (older), .mdx (Markdown with embedded JSX, used by some static sites), or .mdown. All the same thing.

How to open an MD file

The lazy answer: drag it into a browser. Chrome and Firefox display the raw text. Not ideal - you want it formatted.

The 30-second answer: open it on GitHub. Push the file to a repo (public or private) and GitHub renders it in the file view. Free, no install.

The 5-second answer: drop it into Markdown Tidy's editor. Paste or drag the file, see the formatted preview instantly, export to PDF / DOCX / HTML if you need a real document. Runs in your browser, nothing uploaded.

The local answer: a dedicated Markdown viewer:

• Mac: MacDown, Typora, Marktext - all free or low-cost
• Windows: Typora, MarkText, Mark Text
• VS Code: open the file, hit Ctrl+Shift+V (or Cmd+Shift+V) for the preview pane
• Cross-platform: Obsidian, Mark Text, StackEdit (browser-only)

See Typora alternatives for the full editor list and Markdown viewer online for the web-based options.

How to convert an MD file

The point of receiving or producing an MD file is rarely to keep it as an MD file. Common conversions:

• MD → PDF - for sharing, printing, or sending to people who don't use Markdown. Four methods compared in Markdown to PDF.
• MD → DOCX (Word) - for handoff to stakeholders who'll keep editing. Often the right pick even when "PDF" was the default request. See Markdown to Word.
• MD → HTML - for web publishing, email templates, or embedding in another page. Markdown to HTML.
• MD → PNG / image - for screenshots of formatted content. Less common.

The shortest path for any of these in a browser: Markdown Tidy editor. Paste, click Export, choose the format. No install.

"I've many MD files, I want them all converted"

Batch conversion is where command-line tools earn their keep:

# Pandoc — install once, convert many
for f in *.md; do pandoc "$f" -o "${f%.md}.pdf"; done

# Or to DOCX
for f in *.md; do pandoc "$f" -o "${f%.md}.docx"; done

Pandoc is the canonical CLI for Markdown conversion. Heavy install (1-4 GB if you also want PDF output via LaTeX) but unbeatable for repeatable, scripted work.

For repeated programmatic conversion without installing anything, the Markdown Tidy API does the same thing over HTTP. POST your Markdown, get back a PDF.

"The MD file looks broken in the renderer I tried"

Welcome to the most common Markdown frustration in 2026. Three usual suspects:

1. The dialect doesn't match. GFM (GitHub Flavored Markdown) tables don't render in CommonMark-only viewers. See GitHub Flavored Markdown.
2. The Markdown is actually broken. AI assistants produce tables with mismatched column counts, lists with stray punctuation, fenced code blocks that never close. See How to repair broken Markdown tables in 30 seconds and the AI Markdown cleanup checklist.
3. Smart quotes / Unicode mess. Copy-pasted text drags "smart quotes", em dashes, and zero-width spaces into the file. ChatGPT formatting artifacts covers the eight most common cases.

Markdown Tidy catches all three categories in one Tidy click and lets you re-export.

MD file vs Markdown vs .markdown

Same thing. .md is the short form, .markdown is the explicit form, .mdx is the variant that allows embedded React components (used by Docusaurus, Astro, MDX-based static sites). For everyday writing, use .md.

What's next

If the file came from an AI assistant: why ChatGPT Markdown breaks in Google Docs explains the pattern.

If the file is going to a client or a colleague: the DOCX vs PDF picker helps you choose the export format.

If you'd rather just have a polished version of the file right now: paste it into the editor.