Skip to content
HN On Hacker News ↗

A Markdown File Should Just Open

▲ 64 points • 85 comments • by TheWoollyBully • 2w ago • HN discussion ↗

Pangram verdict · v3.3

We believe that this entire text is AI.

100 %

AI likelihood · overall

AI
0% human-written 100% AI-generated
SEGMENTS · HUMAN 0 of 1
SEGMENTS · AI 1 of 1
WORD COUNT 1,509
PEAK AI % 100% · §1
Analyzed
Oct 22
backend: pangram/v3.3
Segments scanned
1 windows
avg 1509 words each
Distribution
0 / 100%
human / AI fraction
Verdict
AI
Pangram v3.3

Article text · 1,509 words · 1 segments analyzed

Human AI-generated
§1 AI · 100%

It seems strange to me that in 2026 we still cannot open a Markdown document on just about any computer or phone and expect it to display properly without installing additional software. Markdown has been around for more than 20 years and has become an essential format for documentation, writing, publishing and sharing information. It is simple, portable, human-readable and supported by an enormous collection of applications and websites. Yet something as ordinary as receiving a .md file can still leave people staring at raw formatting syntax or looking for an application capable of displaying it as a document. We have operating systems that can open photographs, play videos, read PDFs and recognize countless complicated file formats without requiring us to think about how any of that works. I think Markdown deserves the same treatment.I have been using Markdown for years, and it has become one of my favorite ways to write and organize information. Much of the content on my personal website begins as Markdown because it allows me to focus on writing rather than formatting. I can keep those files in Git, edit them with almost any text editor, convert them into webpages and preserve the original documents without depending on a proprietary application. There is something wonderfully reassuring about knowing that the words I write today should remain accessible decades from now, even if every application I currently use disappears. A Markdown document does not require an account, a subscription, a particular company or a complicated file format to remain useful. That simplicity is precisely why I think it should be treated as a first-class document throughout the computing world.We have made something simple unnecessarily complicatedOne of the original ideas behind Markdown was that a document should remain readable even before a computer interprets its formatting. John Gruber introduced the format in 2004 with help from Aaron Swartz, using ordinary text conventions to represent headings, links, emphasis and other common document structures. The result was a way to write structured material without surrounding every sentence with HTML tags or working inside a specialized document editor. Anyone who has opened a README file in a software repository has probably encountered Markdown, even if they did not know what the format was called. Its usefulness eventually spread far beyond programming into books, technical documentation, academic notes, publishing systems and personal knowledge collections. The format succeeded largely because it required so little from the software used to create it.That is what makes the current situation so frustrating. Markdown is already plain text, so nearly every operating system can technically open it with some kind of text editor. The missing piece is treating the file as a document instead of merely displaying the characters used to describe its formatting. A heading should look like a heading, a table should look like a table, and a link should behave like a link. If I want to see the original Markdown syntax, I should be able to switch to that view just as easily. None of this should require finding an obscure utility, installing a preview extension or moving the document into an application that converts it into another format.I can send someone a PDF with a reasonable expectation that their computer or phone will know what to do with it. They can usually open the file, read the contents, search for text and navigate the document without worrying about which company manufactured their device. Markdown should be at least that easy to read, especially considering how much simpler the underlying format is. Unlike PDF, Markdown is also designed to be edited directly, which makes consistent support even more valuable. A person should be able to read a document on their phone, make a correction on their laptop and continue working on a tablet without changing the underlying file. That is the sort of experience we should expect from a modern operating system.Every operating system should understand MarkdownI initially started thinking about this because of the inconsistent experience across Apple's operating systems. Apple has added Markdown import and export to Notes, which I was happy to see, but importing a document converts it into the rich-text format used by Notes. That is useful for moving information between applications, but it is not the same as opening the original Markdown file, editing it and saving it in place. Finder, Quick Look and Files already understand how to present many kinds of documents, yet Markdown still does not have a complete native viewing and editing experience across macOS, iOS, iPadOS and visionOS. I would like to see that change because a Markdown document should not require a different workflow depending on which Apple device happens to be in my hands.This is not exclusively an Apple problem, however, and I do not think the solution should be limited to Apple's ecosystem. Windows, Linux, Android and every other modern computing environment should recognize Markdown as an ordinary document format. Microsoft has made encouraging progress by introducing Markdown formatting directly into Windows 11 Notepad, including the ability to switch between formatted text and Markdown source. Linux has a wonderful collection of text editors and Markdown tools, although the experience varies between distributions, desktop environments and installed applications. Android also has plenty of capable third-party Markdown editors, but that does not guarantee a consistent formatted reading and editing experience through the default file-handling system. We have pieces of the solution scattered throughout the industry without a common expectation that the experience should work everywhere.I do not expect every operating system to render Markdown with identical fonts, spacing or visual styling. In fact, I would prefer that the presentation respect the user's own system settings and accessibility preferences. What should remain consistent is the structure of the document and the ability to work with the same underlying file. A Markdown document created on Linux should open naturally on Windows, remain editable on Android and display properly on an iPhone. The person using the file should not have to understand which application originally created it or which Markdown rendering engine the operating system uses. That is the kind of interoperability that makes a format genuinely useful across different platforms.We already have the standardsThe interesting part is that much of the difficult work involved in agreeing on how Markdown should behave has already been done. The original Markdown syntax left some behavior open to interpretation, which eventually produced differences between applications and rendering engines. The CommonMark project addresses those ambiguities by providing a well-defined specification and extensive examples for implementers. GitHub Flavored Markdown builds on that foundation with widely used features such as tables, task lists, strikethrough and automatic links. Those conventions already support an enormous amount of documentation and written material circulating around the internet. Operating system developers do not need to invent another document format to make this work.There will always be extensions that particular applications support and others do not. Some writers use footnotes, mathematical notation, diagrams, embedded HTML or specialized publishing syntax that goes beyond CommonMark and GitHub Flavored Markdown. I do not expect every built-in document viewer to reproduce every possible extension exactly. What I do expect is a reliable baseline that renders ordinary Markdown correctly while preserving anything the application does not understand. Opening and saving a file should never silently discard unfamiliar syntax just because the built-in editor does not know how to display it. The entire point of using a portable text format is that applications should not need to control every possible feature to preserve the document.There are also sensible security considerations whenever an operating system renders documents from unfamiliar sources. A Markdown preview should not execute arbitrary scripts, load untrusted content without appropriate safeguards or expose information simply because the file references an external resource. Those are familiar problems that operating systems already handle when presenting PDFs, HTML and other document formats. A renderer can provide useful formatting while treating the underlying file as untrusted content. It can also work entirely offline for ordinary documents, without requiring a cloud service to interpret a few headings and paragraphs. Markdown's simplicity should make it easier to build a safe native experience rather than another excuse to move document processing onto somebody else's servers.Artificial intelligence is making Markdown even more importantOne of the unexpected developments of the past few years is how prominently Markdown has appeared in the growing ecosystem of artificial intelligence. Language models frequently use Markdown conventions to organize their responses because it provides a convenient way to communicate headings, lists, tables, code and other structured information through ordinary text. Developers use Markdown for agent instructions, project documentation, technical specifications and the many files that help AI tools understand the software they are working on. People who have never written code are encountering Markdown through exported conversations, generated reports and documents produced by AI services. The format has effectively become one of the common languages through which people and software exchange structured written information. I suspect that visibility will continue increasing as AI becomes part of more everyday workflows.That makes native support