Markdown for Beginners: The Simple Formatting Language You Should Know

You have probably seen something like bold or # Title somewhere on the internet. That is Markdown. It is a simple way to format text using regular characters on your keyboard. No buttons. No menus. Just type.

Once you learn the basics, you can write notes, READMEs, blog posts, and documentation faster than ever.

What Is Markdown?

Markdown is a lightweight markup language created in 2004 by John Gruber. The idea is simple: you write plain text with a few extra characters, and a tool converts it into formatted output.

It looks like this:

# My Note
This is important. And this is less important.
Item one
Item two

And it becomes this:

My Note

>

This is important. And this is less important.

>

- Item one

- Item two

Plain text in. Formatted text out.

Why Markdown Is Worth Learning

You probably already use Word, Notion, or Google Docs. So why bother with another format?

• It is fast. No clicking. No toolbars. You type the formatting as you write.
• It works everywhere. Markdown is plain text. Every editor can open it. GitHub, Reddit, Discord, Slack, and most documentation tools all understand it.
• It does not lock you in. Your file is just text. You can open it in any app, today or 30 years from now.
• It is readable raw. Even without rendering, you can understand the structure.

For developers it is the default. For writers and note-takers it is a quiet superpower.

The Core Syntax in 2 Minutes

Headings

Use # for headings. More # means smaller heading.

# H1 — page title
H2 — section
H3 — subsection

Bold and Italic

bold text
italic text
bold and italic

Lists

Unordered list:

- Coffee
Tea
Water

Ordered list:

1. Wake up
Drink coffee
Start writing

Links and Images

EDTR
!Alt text

Code

Inline code uses backticks: ` code `

Code blocks use three backticks:

\\\`javascript
console.log("hello")
\\\`

Quotes

> This is a quote.
> It can span multiple lines.

Horizontal Rule

Three dashes:

---

That is 90% of what you will ever need.

Where to Use Markdown

Markdown is everywhere once you start looking:

• GitHub READMEs and issues
• Reddit and Stack Overflow posts
• Discord and Slack messages
• Notion, Obsidian, Bear, and most modern note apps
• Static site generators like Next.js, Hugo, and Jekyll
• Documentation tools like Docusaurus and GitBook

If you can write Markdown, you can publish to all of these without learning anything new.

Live Preview in EDTR

EDTR has a built-in Markdown preview. Open a file, switch the language to Markdown from the bottom status bar, and you will see your text rendered in real time as you type.

It supports:

• Standard Markdown syntax
• GitHub-flavored extensions (tables, task lists, strikethrough)
• Math equations via LaTeX
• Code highlighting for 20+ languages
• Mermaid diagrams
• ABC notation for music

Press ⌘⇧V to toggle the preview panel.

A Quick Practice Exercise

Open EDTR and paste this in:

# My First Markdown Note
I am learning Markdown. So far I know:
How to make headings
How to bold and italic
How to make lists

> The hardest part was finding a tool that does not get in my way.
Useful link: EDTR

Switch to Markdown mode and watch it render. That is it. You know Markdown now.

What Is Not in Markdown

A few things Markdown intentionally leaves out:

• Font choice
• Font size
• Text color
• Page layout

This is a feature, not a bug. Markdown focuses on structure, not style. The rendering tool decides how it looks. Your job is to write — clearly.

Try It Now

The best way to learn Markdown is to use it. Open edtr.plus, switch a tab to Markdown, and start writing your next note in plain text with structure.

You will not go back.

---

Plain text. Real structure. That is Markdown.