What Is an .md File?

The .md File Extension

A file ending in .md is a Markdown file — a plain-text document that uses simple formatting symbols to represent headings, bold text, links, lists, and code blocks. The most common example is README.md, the file that appears on the front page of almost every GitHub repository.

Markdown was created by John Gruber in 2004 as a way to write formatted content that is still easy to read in its raw form. Today it is used everywhere: documentation, notes, wikis, blogs, and technical specs.

What Is the Full Form of .md?

The full form of .md is Markdown. The .md extension is simply a shortened form of the word — the same way .jpg stands for JPEG and .png stands for Portable Network Graphics.

Some common questions:

Is .md the same as Markdown?

Yes. The .md file extension is the standard extension for Markdown files. You may also see .markdown (the full name), but .md is far more common. GitHub, GitLab, VS Code, and virtually all modern tools default to .md.

Why “Markdown” and not “Markup”?

Markdown was created as a counterpart to HTML (“HyperText Markup Language”). Where HTML is complex markup with angle brackets and attributes, Markdown is the simpler alternative — hence “markdown” instead of “markup”. The name is intentionally playful.

Are there other meanings of .md?

In file extensions, .md almost always means Markdown. In other contexts, “MD” can stand for Medical Doctor, Maryland, or Managing Director — but when you see a .md file on your computer or in a code repository, it’s a Markdown document.

What's Inside an .md File?

An .md file is just plain text with lightweight formatting. Here's what Markdown syntax looks like:

• # Heading — creates a heading
• **bold** — makes text bold
• - item — creates a bullet list
• [link](url) — adds a hyperlink
• `code` — inline code
• ``` — fenced code blocks

You can open any .md file in a basic text editor and read it, but a dedicated md file reader renders the formatting so you see headings, bold text, and code blocks as they were intended.

Where You'll Encounter .md Files

• GitHub & GitLab — README.md, CONTRIBUTING.md, CHANGELOG.md
• Documentation — API docs, project specs, architecture notes
• Note-taking — Obsidian, Bear, and other apps store notes as .md files
• Static site generators — Jekyll, Hugo, Astro use Markdown for content
• Developer workflows — meeting notes, ADRs, runbooks

How to Open .md Files on macOS

macOS doesn't include a built-in Markdown viewer. Here's how the main options compare:

For a detailed walkthrough of each method, see our guide on how to open .md files on Mac.

Open .md Files Instantly with MDViewer

MDViewer is a free, native macOS md file reader built with SwiftUI. It does one thing well: open .md files and render them beautifully.

• Set as default app — double-click any .md file in Finder to open it instantly
• Tabbed interface — open multiple files in one window
• Smart table of contents — navigate long documents by heading
• Inline editing — double-click to edit, ⌘S to save
• Git history — browse file revisions and diffs without leaving the app
• GitHub Flavored Markdown — tables, task lists, code blocks with syntax highlighting

Requires macOS 13.0 or later. Intel and Apple Silicon.

FAQ

What is the full form of .md file?

The full form of .md is Markdown. The .md extension is a shorthand for Markdown, a lightweight markup language created by John Gruber in 2004 for writing formatted text in plain text files.

Can I edit .md files or just view them?

With MDViewer, you can do both. Double-click any word to enter edit mode, make your changes, and press ⌘S to save. Press Esc to return to reading.

Is .md the same as .markdown?

Yes. Both extensions refer to Markdown files. .md is the more common convention. MDViewer handles both.

Are .md files safe to open?

Yes. Markdown files are plain text — they cannot contain viruses or executable code. They are one of the safest file types you can open.

Can I convert .md to PDF?

Yes. MDViewer has built-in PDF export — press ⌘⇧E to save any Markdown file as a PDF with smart page breaks. You can also print from any app and choose “Save as PDF” from the print dialog. Going the other way? See our guide on converting PDF to Markdown.