You have already used Markdown. Almost certainly. If you have ever typed asterisks around a word in Discord to make it bold, started a line with a hyphen in a notes app, or read a README file on GitHub, you were looking at Markdown. You were probably doing it without knowing it had a name.
It was created in 2004 by a writer named John Gruber who wanted a way to format text for the web without writing HTML. His goal was simple: the raw text should look clean and readable even before any app renders it, with the symbols feeling natural rather than technical. Two decades later it powers documentation, note-taking apps, developer tools, chat platforms, and AI assistants the world over.
The core syntax takes about ten minutes to learn. Here it is.
Headings
Put a # symbol at the start of a line followed by a space and you have a heading. Add more hash symbols for smaller heading levels, exactly like heading styles in a Word document.
# Large heading
## Medium heading
### Smaller headingOne hash for a page title, two for a main section, three for a subsection. That covers everything most people ever need.
Bold and Italic
Wrap text in two asterisks on each side for bold. One asterisk on each side for italic. Three for both at once.
**This is bold**
*This is italic*
***This is bold and italic***Stick to asterisks rather than underscores. Both technically work but asterisks behave more reliably across different apps and parsers, especially when used inside a word.
Lists
A hyphen followed by a space creates a bullet point. Numbers followed by a full stop create a numbered list.
- First item
- Second item
- Third item
1. Step one
2. Step two
3. Step threeIndent with two spaces to nest a list inside another list.
Links
The visible link text goes in square brackets, immediately followed by the URL in regular brackets. No space between the two parts.
[Click here to learn more](https://example.com)That renders as a clickable link showing the text you wrote, pointing to the address in the brackets.
Images
Almost identical to links, with an exclamation mark at the front and descriptive alt text in the square brackets.
The alt text describes the image for screen readers and for cases where the image fails to load.
Code
For a short piece of code or a technical term sitting inline with your text, wrap it in a single backtick on each side.
Use the `ipconfig` command to find your IP address.For a full block of code on its own lines, wrap it in three backticks above and below. Add the language name after the opening backticks for syntax highlighting.
```python
print("Hello, world")
```Blockquotes
A > symbol at the start of a line creates a blockquote, useful for pulling out a key quote or an important note.
> The best time to plant a tree was twenty years ago.
> The second best time is now.Everything at a Glance
| What you want | What you type |
|---|---|
| Large heading | # Heading |
| Smaller heading | ## Heading |
| Bold | **bold text** |
| Italic | *italic text* |
| Bold and italic | ***bold and italic*** |
| Bullet list | - item |
| Numbered list | 1. item |
| Link | [text](url) |
| Image |  |
| Inline code | `code` |
| Code block | ``` above and below |
| Blockquote | > quoted text |
| Strikethrough | ~~crossed out~~ |
That table covers 95% of everything you will ever write in Markdown.
Where It Works Right Now
Markdown is more widespread than most people realise. GitHub renders .md files automatically, making it the standard for project documentation and README files. Obsidian stores all notes as Markdown files on your PC, readable in any text editor forever. Notion supports Markdown shortcuts as you type. Discord and Slack both render bold, italic, code, and strikethrough in messages. Reddit uses Markdown for post and comment formatting. VS Code has built-in Markdown preview.
Even AI assistants output Markdown by default. When a response comes back with bold headings, bullet points, and code blocks, that is Markdown rendering in your browser.
The One Thing That Trips People Up
The most common beginner mistake is forgetting the space after the symbol. #Heading does nothing. # Heading with a space after the hash works correctly. The same applies to lists. -item is just text with a hyphen. - item with a space after the hyphen creates a bullet point. The space is part of the syntax.
The other catch is paragraphs. Pressing Enter once in most Markdown apps does not start a new paragraph, it continues the same one. You need a blank line between two blocks of text to create a proper paragraph break.
Final Thoughts
Markdown has spread across the internet not because any company pushed it hard, but because it genuinely solves a real problem. The text stays readable before rendering. The files stay portable forever. Learn it once and it works nearly everywhere. Ten minutes of learning, and you have a skill that quietly turns out to be useful all the time.
Frequently Asked Questions
Do I need to install anything to use Markdown?
No. You can write Markdown in any plain text editor, including Notepad on Windows. If you want to see it rendered as you type, free tools like Typora offer live preview, and VS Code has Markdown preview built in. Most apps that support Markdown render it automatically.
Is Markdown the same on every platform?
The core syntax, headings, bold, italic, links, lists, and code, is consistent across almost all platforms. Extended features like tables, task lists, and strikethrough are part of GitHub Flavored Markdown and work on GitHub, Notion, Obsidian, and many others, but not universally everywhere. For everyday writing the core syntax is all you need.
Can I use Markdown in Microsoft Word or Google Docs?
Not natively, though both have workarounds. Google Docs can import Markdown files and convert them. For serious Markdown writing, dedicated tools like Obsidian, Typora, or VS Code are more natural fits. If you paste rendered Markdown into Word or Google Docs, the formatting usually transfers correctly.
What is the difference between Markdown and HTML?
Both format text for the web. HTML uses tags like <strong> for bold and <h1> for headings. Markdown uses ** for bold and # for headings. Markdown is faster to write and easier to read as plain text. It is typically converted to HTML behind the scenes by whatever app you are using.
Where should I save Markdown files?
Markdown files use the .md extension and can be saved anywhere on your PC. They are plain text files that open in any text editor. There is no special location required and they never become unreadable due to software changes, which is part of why writers and developers trust them for long-term notes and documentation.
Discussion (0)
Be the first to comment.