What Is a Markdown File? A Beginner-Friendly Explanation

By M. Hassan Ali Published January 8, 2025 3 min read

Open a file that ends in .md and you'll usually see something like this:

# Project Notes

This is **important** and this is *less important*.

- First thing to check
- Second thing to check

That's a Markdown file. It's a plain text file — the kind you could open in Notepad, TextEdit, or even a phone's basic notes app — with a small set of symbols sprinkled in that tell a program how to format the text later. The hash sign makes a heading, the asterisks make bold or italic text, and the dashes make a list. That's most of what you need to know to read one.

Why not just use Word or Google Docs?

Markdown solves a specific annoyance: formatted documents (.docx, .pages, .odt) are actually complex files under the hood, even if they look simple on screen. That makes them awkward to store in version control, hard to diff line-by-line, and sometimes tricky to open years later if the software changes. A Markdown file is just text — readable by literally anything, forever, and easy to track changes on in tools like Git.

That's why it became the default for README files, technical documentation, blog drafts, and note-taking apps like Obsidian and Notion. It's fast to type (no reaching for the mouse to hit "bold"), and the file stays small and portable.

What the common symbols do

# Heading — one hash for a top-level heading, two for a subheading, and so on up to six.
**bold** and *italic* — double asterisks for bold, single for italic.
- item or * item — a bullet list item.
1. item — a numbered list item.
[link text](https://example.com) — a clickable link.
> quote — a blockquote.
Triple backticks around a block — a code block, usually shown in a monospaced font.

How to actually view one formatted

A plain text editor will show you the raw symbols, not the formatted result. To see it rendered — headings actually bigger, bold actually bold — you need something that understands Markdown: a code editor with a preview pane (VS Code, for example), a dedicated Markdown app, or a converter that turns it into HTML or PDF. That's exactly what the Markdown to HTML tool on this site does — paste your Markdown in and see the formatted version immediately.

Is a .md file the same as a .txt file?

Functionally, almost — both are plain text. The difference is intent: a .txt file usually isn't meant to have any special symbols interpreted, while a .md file's symbols are meant to be turned into formatting by something that understands Markdown. You can rename a .md file to .txt and back with zero data loss, since nothing about the actual content changes.

Frequently asked questions

Can I open a Markdown file in Microsoft Word?: Yes, but Word will show the raw symbols (the # and ** characters) rather than formatted text, since Word doesn't interpret Markdown on its own.
Do I need special software to write Markdown?: No — any plain text editor works. A Markdown-aware editor just adds a live preview, which is convenient but not required.

How this guide was prepared: This guide sticks to the CommonMark-style syntax supported by most editors and the tools on this site; a handful of platforms (GitHub, Notion, etc.) add their own small extensions on top.