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, Markdown files are used everywhere: documentation, notes, wikis, blogs, and technical specs. If you’re new to the syntax, see our Markdown cheat sheet.

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. Markdown also supports tables and diagrams via extensions like Mermaid.

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 (see how Markdown readers for Mac handle them)
• Static site generators — Jekyll, Hugo, Astro use Markdown for content
• Developer workflows — meeting notes, ADRs, runbooks
• AI tools — ChatGPT, Claude, and other LLMs output Markdown by default

What Does "Download as MD" Mean?

AI tools like ChatGPT and Claude often show a “download as MD” button. This saves the conversation as a Markdown file (.md) so you keep all the formatting — headings, code blocks, lists, and links — instead of getting a flat wall of text.

Once downloaded, you need to open the .md file locally to see it properly. A plain text editor will show raw syntax, but a dedicated viewer like MDViewer renders headings, code blocks, and tables as they were intended. See our step-by-step guide on how to open .md files on Mac to set up a default viewer — after that, double-clicking any downloaded .md file opens it instantly with full formatting.

For more on working with AI-generated Markdown, see our guide on viewing Markdown from AI tools.

.md vs .txt — What's the Difference?

Both .md and .txt are plain-text files you can open in any editor. The difference is that Markdown files use lightweight syntax to encode formatting:

If you only need raw notes, .txt works. If you want structure, formatting, and portability across tools, .md is the better choice. See our editor vs viewer comparison for more on how to work with Markdown files.

How to Create a .md File on Mac

There are several ways to create a new Markdown file on macOS:

Terminal

Open Terminal and run: touch notes.md — this creates an empty .md file in the current directory. Then open it in your preferred Markdown editor.

TextEdit

Open TextEdit, switch to plain text mode (Format → Make Plain Text), write your content, then save with a .md extension. macOS may try to add .txt — uncheck “If no extension is provided, use .txt” in the save dialog.

MDViewer

MDViewer supports inline editing — double-click any word to enter edit mode, make changes, and press ⌘S to save. You can create new files or edit existing .md files without leaving the app.

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.

Can I open .md files without VS Code?

Yes. You don’t need a heavy code editor to open Markdown files. On Mac, a lightweight viewer like MDViewer opens .md files instantly with full rendering — headings, tables, code blocks, and Mermaid diagrams. You can also use TextEdit for raw text or the free online Markdown viewer on any platform. See our full guide on how to open .md files on Mac for all five methods.

What is the .md file extension?

The .md file extension stands for Markdown. It indicates a plain-text file formatted with Markdown syntax — a lightweight markup language used for documentation, README files, notes, and technical writing. It’s the same as .markdown, just shorter. Learn more in our Markdown writing guide.

What program opens .md files on Mac?

MDViewer is a free, native macOS app built specifically for reading .md files. You can also open them in TextEdit (raw text), VS Code (with preview pane), or Xcode (basic rendering). For the best experience, set MDViewer as your default app in Finder — see our best Markdown viewers for Mac comparison.

What does "download as MD" mean?

When an AI tool like ChatGPT or Claude offers “download as MD”, it saves the conversation as a Markdown (.md) file. This preserves all formatting — headings, code blocks, lists, and links. Open the downloaded file with MDViewer or any text editor. See our guide on viewing Markdown from AI tools.

What is the difference between .md and .txt?

Both are plain-text files, but .md files use Markdown syntax to encode formatting (headings, bold, links, code blocks, tables). A .txt file has no formatting conventions. When opened in a Markdown viewer, .md files render as rich documents; .txt files always display as plain text.

How do I create a .md file on Mac?

Open Terminal and run touch filename.md to create an empty Markdown file. You can also use TextEdit (switch to plain text mode first) or a Markdown editor. MDViewer supports inline editing — double-click to edit, ⌘S to save.