Formats/Markdown
What Is Markdown? The Plain-Text Formatting Language Explained
Markdown is a lightweight markup language for writing formatted text using nothing but plain, readable symbols. Created by John Gruber in 2004, its goal was simple: let people write something that reads naturally as plain text but can be converted to clean HTML — so you get headings, bold, lists and links without ever leaving the keyboard or wrestling with formatting buttons. Files are saved with a .md extension.
How Markdown works
Instead of clicking a “bold” button, you wrap text in asterisks: `**like this**`. A heading is a line starting with `#` (more hashes mean smaller headings). A bullet list is lines starting with `-`. A link is `[text](url)`. Inline code goes between backticks. The symbols are deliberately unobtrusive, so even the raw, unrendered text stays perfectly readable — which is a big part of the appeal.
When you are ready to publish, a Markdown processor converts those symbols into formatted output, usually HTML. You write in one simple, portable plain-text file, and it renders into properly structured, styled content wherever it is displayed.
Why Markdown became so popular
Markdown took over technical and writing communities because it is fast, portable and future-proof. It is fast because your hands never leave the keyboard. It is portable because a .md file is just plain text — it opens in any editor, on any device, and will still be readable in fifty years, with no proprietary format to lock it away. And it keeps content and presentation separate, so the same document can be styled differently in different places.
That is why it is now the default for README files on GitHub and GitLab, software documentation, static-site blog posts, chat tools like Slack and Discord, forums, and a whole generation of note-taking apps.
Flavors and limits
Because the original Markdown spec left some things unspecified, several “flavors” emerged that add features — GitHub Flavored Markdown, for instance, adds tables, task lists, strikethrough and fenced code blocks. Most are compatible for the basics but differ at the edges, so a document that renders one way on GitHub might look slightly different elsewhere.
Markdown is intentionally limited: it covers common formatting, not precise layout. When you need fine control — exact spacing, columns, complex tables — you either drop into raw HTML (which most Markdown allows) or reach for a different tool. For the vast majority of writing, though, its small vocabulary is a feature, not a shortcoming.
How to preview and export Markdown
The one catch with Markdown is that the symbols you type do not look like the finished result, which makes it easy to misjudge how a heading or list will render. A live preview solves this: you type Markdown on one side and see the formatted output update on the other. OfficePad’s Markdown editor does exactly that in the browser and lets you copy the rendered HTML to paste into a web page, or keep the Markdown source for wherever it needs to go — all without uploading anything.
Frequently asked questions
What is a .md file?
A .md file is a plain-text document written in Markdown, a lightweight syntax that uses symbols like # and ** to indicate formatting such as headings and bold text.
How do I preview Markdown?
Use a Markdown editor with a live preview, which shows the formatted result as you type. OfficePad’s Markdown editor does this in the browser and can export the rendered HTML.
Is Markdown the same everywhere?
Mostly. The basics are consistent, but “flavors” like GitHub Flavored Markdown add extras such as tables and task lists, so advanced features can render differently across platforms.
Work with Markdown on OfficePad
See also in the glossary: Character encoding, UTF-8, Rendering.