[{"data":1,"prerenderedAt":72},["Reactive",2],{"blog-post-what-is-an-md-file-and-how-to-open-it":3},{"slug":4,"title":5,"description":6,"excerpt":7,"date":8,"category":9,"author":10,"keywords":11,"readingMinutes":12,"html":13,"headings":14,"tools":37,"related":44},"what-is-an-md-file-and-how-to-open-it","What Is an MD File and How Do You Open It?","An .md file is a plain text file written in Markdown. Here is how to open, read and edit one on Windows, Mac, Linux, iPhone and Android, and why it looks like gibberish in some programs.","You downloaded a file called README.md or notes.md, double-clicked it, and your computer either asked which app to use or opened it full of pound signs and asterisks. Nothing is wrong with the…","2026-10-26","Guide","Matthew Rathbone","what is a md file, how to open md file, md file viewer, md viewer, open md file, md file reader, markdown file viewer, .md file extension, how to view markdown files",5,"\u003Cp>You downloaded a file called \u003Ccode>README.md\u003C/code> or \u003Ccode>notes.md\u003C/code>, double-clicked it, and your computer either asked which app to use or opened it full of pound signs and asterisks. Nothing is wrong with the file. It is just text that expects to be rendered.\u003C/p>\n\u003Cp>This guide explains what an MD file is, the fastest way to read one on each device, and how to tell when a file with that extension is not Markdown at all.\u003C/p>\n\u003Ch2 id=\"what-an-md-file-is\">What an MD file is\u003C/h2>\n\u003Cp>An MD file is a plain text file that uses Markdown, a set of simple conventions for formatting text. A \u003Ccode>#\u003C/code> at the start of a line makes a heading, \u003Ccode>**word**\u003C/code> makes bold text, \u003Ccode>-\u003C/code> starts a bullet, and so on. The extension is usually \u003Ccode>.md\u003C/code>, though \u003Ccode>.markdown\u003C/code>, \u003Ccode>.mdown\u003C/code> and \u003Ccode>.mkd\u003C/code> mean the same thing.\u003C/p>\n\u003Cp>Because it is plain text, an MD file:\u003C/p>\n\u003Cul>\n\u003Cli>opens in any text editor, even Notepad\u003C/li>\n\u003Cli>is small and easy to store in Git\u003C/li>\n\u003Cli>looks readable even before it is rendered\u003C/li>\n\u003Cli>has no hidden binary data, so it cannot hide macros or embedded objects the way a Word file can\u003C/li>\n\u003C/ul>\n\u003Cp>Here is what the raw text looks like next to what a viewer shows:\u003C/p>\n\u003Cdiv class=\"table-responsive\">\u003Ctable class=\"table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>In the file\u003C/th>\n\u003Cth>Rendered as\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode># Install guide\u003C/code>\u003C/td>\n\u003Ctd>A large heading\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>**Important**\u003C/code>\u003C/td>\n\u003Ctd>\u003Cstrong>Important\u003C/strong>\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>- item\u003C/code>\u003C/td>\n\u003Ctd>A bullet point\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>[docs](https://example.com)\u003C/code>\u003C/td>\n\u003Ctd>A clickable link labeled "docs"\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>`npm install`\u003C/code>\u003C/td>\n\u003Ctd>Inline code in a monospace font\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\u003C/div>\n\u003Cp>If you want the full syntax, the \u003Ca href=\"/blog/markdown-syntax-cheatsheet-quick-reference-complete-guide\">Markdown cheat sheet\u003C/a> covers every element.\u003C/p>\n\u003Ch2 id=\"the-fastest-way-to-read-one-a-browser\">The fastest way to read one: a browser\u003C/h2>\n\u003Cp>If you only want to read the file, you do not need to install anything. Open the \u003Ca href=\"/tools/markdown-viewer\">Markdown viewer\u003C/a>, then either click Open .md file or drag the file onto the page. It renders the document with an outline, and the file stays on your computer because the page reads it locally.\u003C/p>\n\u003Cp>A few things that help:\u003C/p>\n\u003Cul>\n\u003Cli>If the file is on GitHub, paste its address into the From URL box. Links containing \u003Ccode>/blob/\u003C/code> are converted to the raw file automatically.\u003C/li>\n\u003Cli>Use the Print / PDF button to save a rendered copy.\u003C/li>\n\u003Cli>Images that use relative paths (\u003Ccode>./img/screenshot.png\u003C/code>) will not load, because a browser page cannot see the folder next to the file. That is a limit of every browser-based viewer, not a bug in the file.\u003C/li>\n\u003C/ul>\n\u003Ch2 id=\"open-an-md-file-on-each-system\">Open an MD file on each system\u003C/h2>\n\u003Ch3 id=\"windows\">Windows\u003C/h3>\n\u003Cp>Windows has no built-in Markdown viewer. Right-click the file, choose Open with, and pick Notepad to see the raw text. For a rendered view, use the browser viewer above or one of these:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>VS Code\u003C/strong>: open the file and press Ctrl+Shift+V for a rendered preview, or Ctrl+K then V to see it beside the source.\u003C/li>\n\u003Cli>\u003Cstrong>A notes app\u003C/strong> such as Obsidian or Typora, which show rendered Markdown while you edit. Our \u003Ca href=\"/blog/notes-apps-that-keep-your-notes-as-markdown-files\">notes apps guide\u003C/a> compares them by how they store files.\u003C/li>\n\u003C/ul>\n\u003Ch3 id=\"mac\">Mac\u003C/h3>\n\u003Cp>TextEdit opens the file as plain text. For rendering, VS Code works the same as on Windows (Cmd+Shift+V). Any Markdown editor from the \u003Ca href=\"/directory\">directory\u003C/a> will open it too. You can also install a Quick Look plugin so that pressing Space on the file in Finder shows a rendered preview, though what is available changes with each macOS release, so check that the plugin supports your version.\u003C/p>\n\u003Ch3 id=\"linux\">Linux\u003C/h3>\n\u003Cp>Every distribution opens the file in its default text editor. In a terminal, \u003Ccode>cat notes.md\u003C/code> prints the raw text, and a tool such as Glow renders it with colors and formatting directly in the terminal, which is handy over SSH.\u003C/p>\n\u003Ch3 id=\"iphone-ipad-and-android\">iPhone, iPad and Android\u003C/h3>\n\u003Cp>Phones usually offer to preview the file as text. For a rendered view, open the browser viewer on your phone, or use a Markdown-capable notes app. If the file arrived by email, save it to Files (iOS) or Downloads (Android) first, then pick it from the viewer's file dialog.\u003C/p>\n\u003Ch2 id=\"why-an-md-file-might-look-wrong\">Why an MD file might look wrong\u003C/h2>\n\u003Cp>\u003Cstrong>Raw symbols everywhere.\u003C/strong> That is the normal state of the file in a text editor. Use a viewer to render it.\u003C/p>\n\u003Cp>\u003Cstrong>Line breaks vanish.\u003C/strong> Standard Markdown joins lines that are separated by a single newline. End a line with two spaces or a backslash to force a break, or leave a blank line to start a new paragraph. The \u003Ca href=\"/blog/how-to-insert-a-line-break-in-markdown\">line break guide\u003C/a> has the details.\u003C/p>\n\u003Cp>\u003Cstrong>Tables show as pipes and dashes.\u003C/strong> Tables are an extension supported by GitHub Flavored Markdown and most modern viewers. A bare-bones renderer may ignore them. Our \u003Ca href=\"/tools/markdown-table-formatter\">table formatter\u003C/a> can tidy the source so it stays readable either way.\u003C/p>\n\u003Cp>\u003Cstrong>Garbled characters such as \u003Ccode>’\u003C/code>.\u003C/strong> The file is UTF-8 but your program is reading it as another encoding. Reopen it and choose UTF-8.\u003C/p>\n\u003Cp>\u003Cstrong>The file has a block of settings at the top.\u003C/strong> A section fenced by \u003Ccode>---\u003C/code> lines at the very start is front matter, used by static site generators such as Jekyll and Hugo. It is metadata, not content. The \u003Ca href=\"/tools/yaml-frontmatter-editor\">YAML frontmatter editor\u003C/a> edits it safely.\u003C/p>\n\u003Ch2 id=\"is-every-md-file-markdown\">Is every .md file Markdown?\u003C/h2>\n\u003Cp>Almost always. The main exception is that \u003Ccode>.md\u003C/code> is also used for Sega Mega Drive game ROMs. A ROM shows up as unreadable binary garbage in a text editor, while a Markdown file shows readable sentences with a few symbols. If you can read sentences, it is Markdown.\u003C/p>\n\u003Ch2 id=\"editing-an-md-file\">Editing an MD file\u003C/h2>\n\u003Cp>Any text editor can edit it. If you want to see the result as you type, use the \u003Ca href=\"/tools/markdown-editor\">online Markdown editor\u003C/a>, which shows a live preview and can export HTML. To turn the file into something non-technical readers can open, convert it to \u003Ca href=\"/tools/markdown-to-docx\">Word\u003C/a> or \u003Ca href=\"/tools/markdown-to-pdf\">PDF\u003C/a>.\u003C/p>\n\u003Ch2 id=\"quick-answers\">Quick answers\u003C/h2>\n\u003Cp>\u003Cstrong>Can I rename an MD file to .txt?\u003C/strong> Yes. The content does not change. Rename it back to \u003Ccode>.md\u003C/code> when you want Markdown-aware programs to recognize it again.\u003C/p>\n\u003Cp>\u003Cstrong>Is it safe to open an MD file from an unknown source?\u003C/strong> The text itself is safe. The risk is in what a viewer does with embedded HTML, so use a viewer that sanitizes it. The browser viewer above removes scripts before rendering.\u003C/p>\n\u003Cp>\u003Cstrong>Can I convert an MD file to PDF or Word?\u003C/strong> Yes, with the tools linked in the previous section, or with Pandoc on the command line.\u003C/p>\n\u003Cp>\u003Cstrong>Why do developers use it?\u003C/strong> Plain text diffs cleanly in Git, works in every editor and outlives any single app. That is why README files, documentation and many note apps standardized on it.\u003C/p>\n",[15,19,22,25,28,31,34],{"id":16,"text":17,"level":18},"what-an-md-file-is","What an MD file is",2,{"id":20,"text":21,"level":18},"the-fastest-way-to-read-one-a-browser","The fastest way to read one: a browser",{"id":23,"text":24,"level":18},"open-an-md-file-on-each-system","Open an MD file on each system",{"id":26,"text":27,"level":18},"why-an-md-file-might-look-wrong","Why an MD file might look wrong",{"id":29,"text":30,"level":18},"is-every-md-file-markdown","Is every .md file Markdown?",{"id":32,"text":33,"level":18},"editing-an-md-file","Editing an MD file",{"id":35,"text":36,"level":18},"quick-answers","Quick answers",[38,39,40,41,42,43],"markdown-viewer","markdown-table-formatter","yaml-frontmatter-editor","markdown-editor","markdown-to-docx","markdown-to-pdf",[45,54,62],{"slug":46,"title":47,"description":48,"excerpt":49,"date":50,"category":51,"author":10,"keywords":52,"readingMinutes":53},"markdown-file-organization-project-structure-complete-guide","Markdown File Organization and Project Structure: Complete Guide for Scalable Documentation Systems","Master Markdown file organization strategies for large projects, teams, and documentation systems. Learn directory structures, naming conventions, content management patterns, and scalable organization principles.","Effective Markdown file organization forms the foundation of maintainable, scalable documentation systems that serve teams, users, and automated processes efficiently over time. Strategic…","2025-12-05","Tutorial","markdown file organization, markdown project structure, documentation organization, markdown directory structure, content management markdown, markdown naming conventions, documentation architecture",19,{"slug":55,"title":56,"description":57,"excerpt":58,"date":59,"category":9,"author":10,"keywords":60,"readingMinutes":61},"mkdocs-vs-docusaurus-vs-gitbook","MkDocs vs Docusaurus vs GitBook: Which Documentation Tool Should You Use?","A practical comparison of MkDocs, Docusaurus, and GitBook for technical documentation. Covers setup, features, hosting, pricing, and when to choose each one.","Picking a documentation platform is one of those decisions that’s easy to get wrong. The three tools that come up most often for developer-facing docs are MkDocs, Docusaurus, and GitBook. They all…","2026-05-01","mkdocs vs docusaurus, mkdocs vs gitbook, docusaurus vs gitbook, documentation site generators, technical documentation tools, docs site comparison, mkdocs material",7,{"slug":63,"title":64,"description":65,"excerpt":66,"date":67,"category":68,"author":69,"keywords":70,"readingMinutes":71},"obsidian-vs-notion-vs-roam-note-taking-comparison","Obsidian vs Notion vs Roam Research: Which Note-Taking Tool Should You Use?","An honest, opinionated comparison of Obsidian, Notion, and Roam Research for Markdown-based note-taking — data ownership, collaboration, linking, and when to use each.","Obsidian, Notion, and Roam Research are three of the most discussed note-taking tools among developers, researchers, and knowledge workers — and they represent genuinely different philosophies…","2026-05-08","tool-comparisons","Matt Rathbone","obsidian vs notion, obsidian vs roam, notion vs roam research, best note-taking app, markdown note-taking, obsidian markdown, notion markdown",9,1793257627491]