A markdown file is a plain text document with a .md extension that you can open with almost any program on your computer
Markdown files contain text with straightforward formatting symbols — like asterisks for bold or hyphens for lists — but they are not Word documents or PDFs. You do not need special software to read them. Any text editor that came with your computer will open a .md file, though some programs display the formatting more clearly than others.
The fastest way is to right-click the file, choose "Open with", and pick Notepad (Windows) or TextEdit (Mac). If you want to see the formatting rendered — so bold text actually looks bold instead of showing the asterisks around it — you can use a dedicated markdown editor, a code editor, or even your web browser.
Key Takeaways
- Any text editor can open a markdown file because .md files are plain text, not a proprietary format.
- Right-click the file and select "Open with" to choose which program opens it, or drag it onto an open program window.
- Notepad (Windows) and TextEdit (Mac) show the raw markdown symbols, while dedicated markdown editors and code editors display formatted text.
- If you do not have a markdown editor installed, VS Code and Typora are free or low-cost options that show formatting as you type.
Opening a markdown file with your computer's built-in text editor
Windows users can open any .md file with Notepad, which comes installed on every Windows computer. Right-click the markdown file, hover over "Open with", and select Notepad from the menu. The file will open showing all the raw markdown syntax — the asterisks, brackets, and hash symbols that create the formatting.
Mac users can do the same with TextEdit, which is in your Applications folder under Utilities. Right-click the .md file, select "Open With", and choose TextEdit. One important note: TextEdit defaults to rich text format, so after opening the file, go to Format menu and click "Make Plain Text" to see the markdown properly.
These built-in editors work fine if you just need to read the content or make quick edits. You will see the markdown symbols themselves rather than the formatted result, but the text is all there and readable.
Using a code editor to view markdown with formatting
If you want to see how the markdown will actually look — bold text appearing bold, headers appearing larger — a code editor is the next step up. Visual Studio Code (VS Code) is free, works on Windows and Mac, and opens markdown files with a preview pane that shows both the raw text and the rendered formatting side by side.
read VS Code from code.visualstudio.com, install it, then right-click any .md file and select "Open with Code". Once the file is open, press Ctrl+Shift+V (Windows) or Cmd+Shift+V (Mac) to open the preview pane. You will see your markdown on the left and how it looks formatted on the right.
VS Code is popular with people who write markdown regularly because it is lightweight, free, and handles both editing and preview without switching between programs.
Opening markdown files in a dedicated markdown editor
Dedicated markdown editors are built specifically for writing and reading markdown. Typora is one of the most popular — it shows formatting as you type without displaying the symbols, so you see bold text as bold while you are editing. Typora costs about $15 after a free trial period.
MarkdownPad (Windows only) and iA Writer (Mac and iPad) are other options. These programs often include features like distraction-free writing modes, export to PDF or HTML, and live preview. If you work with markdown files regularly, a dedicated editor can be worth the investment, but it is not necessary just to open and read a file.
Opening markdown in your web browser
If you do not want to install anything, you can open a markdown file in your web browser using an online markdown viewer. Drag and drop the .md file into a browser window, or use a site like Markdown Editor (markdown-editor.github.io) or Dillinger (dillinger.io) and paste the contents in. The browser will render the formatting so you can see how it looks.
This method works on any computer with internet access and requires no installation, but you cannot edit the file this way — you can only view it. If you need to make changes, you will have to save the edited text back to your computer.
Changing which program always opens markdown files
If you open markdown files often, you can set a default program so they always open in your chosen editor instead of Notepad or TextEdit.
On Windows: Right-click a .md file, select "Open with", then "Choose another app". Find the program you want to use and check the box that says "Always use this app to open .md files". Click OK.
On Mac: Right-click a .md file, select "Open With", then the program you want. Hold the Option key and click "Open With" again — the menu will now show "Always Open With". Select your program and confirm.
Troubleshooting when a markdown file will not open
If double-clicking a .md file does nothing, the file extension may not be associated with any program. Right-click the file and select "Open with" to manually choose a program. If "Open with" does not appear, your file may be corrupted or the extension may be wrong — check that the filename actually ends in .md and not something else like .txt or .markdown.
On Mac, if TextEdit opens the file but it looks like gibberish or shows strange characters, you opened it in rich text mode. Close the file, open it again, and when ready go to Format menu and select "Make Plain Text".
If you downloaded the file from the internet and it will not open, your browser may have changed the extension. Check the filename in your Downloads folder — it should end in .md. If it ends in .md.txt or something similar, rename it to remove the extra extension.
Frequently Asked Questions
What is the difference between a markdown file and a regular text file?
Both are plain text, but markdown files use special symbols like * for bold and # for headers. A .md file is just text with those symbols in it — the program you open it with decides whether to show the symbols or render them as formatting. A .txt file is the same thing, just with a different extension.
Can I edit a markdown file and save it?
Yes. Any text editor can edit and save a .md file. Open it, make your changes, and use File > Save or Ctrl+S (Windows) or Cmd+S (Mac). As long as you save it as a .md file and not convert it to another format, the markdown symbols will stay intact.
Do I need to install software to open a markdown file?
No. Notepad (Windows) or TextEdit (Mac) will open any .md file without installing anything. If you want to see the formatting rendered instead of the raw symbols, you can use an online markdown viewer in your browser, also with no installation required.
Why does my markdown file look wrong when I open it?
If the text looks jumbled or has strange characters, the file may have been saved in a different character encoding. Try opening it with a different program — VS Code and most code editors handle encoding better than Notepad. If it still looks wrong, the file itself may be corrupted.
Can I convert a markdown file to a Word document or PDF?
Yes, but you need a program that supports conversion. VS Code has extensions for this, Typora can export to PDF or Word, and online converters like Pandoc (pandoc.org) can convert markdown to many other formats. Most markdown editors have an export or save-as option in the File menu.