What is an .md file?
An .md file is a plain-text document written with Markdown syntax. Projects commonly use Markdown for README.md, setup instructions, changelogs, release notes, and knowledge bases. Characters such as #, backticks, and - [ ] describe headings, code, and task items. A Markdown viewer turns those markers into a formatted document, while a basic text editor shows the source as written.
The best way to open the file depends on what “open” means for your task. You may only need to read the words, edit the source, or verify how the final page will render. Choosing for that task avoids installing a large editor just to inspect one file.
The quickest option: open the .md file in a browser
For a downloaded instruction file or a README someone sent you, open the online Markdown viewer and follow these steps:
- Select Load File and choose an
.md,.markdown,README, or text file. You can also drag the file onto the page. - Read or edit the Markdown source and check the live preview beside it.
- Inspect the table of contents, GFM tables, task lists, highlighted code, Mermaid diagrams, and math where applicable.
- Download the Markdown, export HTML, or use the browser print dialog to save a PDF.
Selected local files and pasted text are processed in the current browser and no account is required. Load URL is different: the browser requests the public raw Markdown address you enter. Do not treat a private, authenticated URL as a public source.
How to open .md files on Windows
Read the source with Notepad
Right-click the file, choose Open with, and select Notepad. This requires no additional software and is useful when you only need the underlying text. Tables, links, and code fences remain visible as Markdown markers. If non-English text appears corrupted, check that the file uses UTF-8 encoding.
Maintain documentation in a code editor
Visual Studio Code and other code editors are better for regular documentation work. They can edit the file, preview common Markdown, search a repository, and show the change beside the Git diff. Files remain on your computer, which is useful for private repositories, but you must install and configure the editor.
Check formatting online
A browser viewer has fewer setup steps when the computer has no development environment or when you only need to review one README. See the Markdown online preview guide when you need to compare support for GFM, Mermaid, and math.
How to open .md files on macOS
TextEdit can read plain-text Markdown. Configure it to use plain-text mode before saving so that it does not turn the document into rich text. Developers can also use a code editor or command-line tools. For read-only inspection, drag the file from Finder into the online viewer without changing the operating system's default application.
Avoid overwriting the original file with a word processor that silently converts its format. Before saving, confirm that the extension is still .md, the encoding is UTF-8, and any line-ending changes are intentional.
How to open Markdown on iPhone, iPad, and Android
Mobile file managers can often display Markdown source but may not render GFM tables or code highlighting. Open the reader in a browser and choose the .md file through the system file picker. Preview-only mode is easier on a small screen. Extensive editing, large tables, and long code samples are still more practical on a desktop device.
If the file arrived through a messaging app, save it to the device's file area first. For sensitive material, avoid unknown conversion sites and do not create a shareable link that other people could forward.
What is the right way to open README.md?
A README can include repository-relative links, task lists, badges, HTML fragments, and images stored elsewhere in the project. A general viewer can check common GFM formatting but cannot reproduce the full GitHub repository context. A relative image may have no base path in a local viewer, and HTML accepted by GitHub may be omitted by a stricter previewer.
Use a local or online preview for the first pass, then check the final page on the target Git platform. The README preview checklist covers these repository-specific details.
Compare the options
| Need | Best starting point | Main limitation |
|---|---|---|
| Read one file quickly | Browser Markdown viewer | Confirm processing and privacy behavior |
| Maintain project docs | Code editor | Installation and extension setup |
| Inspect raw text only | System text editor | No rendered preview |
| Validate a GitHub README | Local preview plus GitHub review | Relative resources and HTML can differ |
Why an .md file may not open correctly
- The actual name is
file.md.txt: show full file extensions and rename it. - The text uses a legacy encoding: convert a copy to UTF-8 and keep the original as a backup.
- The preview differs from GitHub: look for GFM syntax, relative links, or embedded HTML.
- A remote URL will not load: a normal web page is not a raw file URL, or its server blocks cross-origin requests.
- Mermaid stays as code: verify the fenced block uses the
mermaidlanguage and valid diagram syntax.
Takeaway
An .md file does not require proprietary software because it is plain text. Use a system editor to inspect source, a code editor for ongoing maintenance, or open the Markdown viewer for quick reading, rendering checks, and exports. When choosing an online tool, distinguish browser-local processing from services that upload documents to a remote server.