DollarWise

Markdown Basics: A Beginner's Guide to Writing Online

October 11, 2026 · 5 min read · By the DollarWise team
Markdown Basics: A Beginner's Guide to Writing Online

Markdown is the quiet superpower behind half the writing on the internet. READMEs on GitHub, documentation sites, notes apps, blog posts, even this website’s content — all written in Markdown. It looks like plain text, reads like plain text, and magically turns into formatted documents with a couple of symbols.

If you have ever fought with a word processor’s formatting gremlins, Markdown will feel like a breath of fresh air. Here is everything a beginner needs.

What Markdown is — and why writers and developers both love it

Markdown is a lightweight way to format text using simple characters. Instead of clicking toolbar buttons, you type symbols:

  • # Heading becomes a heading
  • **bold** becomes bold
  • - item becomes a list item

Why writers love it: no formatting distractions. You write in plain text, and the document looks clean everywhere — notes app, email draft, phone, desktop. No “why is this paragraph suddenly in a different font” moments.

Why developers love it: Markdown files work perfectly with version control (Git), render natively on GitHub, and convert to HTML with zero manual formatting. Documentation written in Markdown can be reviewed, tracked, and published like code.

Why you will love it: anything you write in Markdown is future-proof. It is plain text — readable in 50 years, convertible to HTML, PDF, Word, slides, ebooks. No proprietary formats, no lock-in. And because the source is just text, your notes, drafts, and documentation stay searchable, lightweight, and easy to back up — a single folder of .md files is an entire writing archive that opens in any editor on any device.

The Markdown cheat sheet (the 15-minute version)

Open a free editor like the DollarWise markdown editor and try each of these — you will see the preview update live.

Headings

# Heading 1
## Heading 2
### Heading 3

More # symbols = smaller heading. Most documents need only two or three levels.

Text formatting

**bold text**
*italic text*
~~strikethrough~~
`inline code`

Lists

- Bullet point
- Another bullet point

1. First step
2. Second step
3. Third step
[link text](https://example.com)
![image description](image-url.jpg)

Blockquotes and code blocks

> This is a quoted paragraph.

```python
print("This is a code block")

(That code block is wrapped in triple backticks — add the language name after the opening backticks for syntax highlighting.)

### Horizontal rules and tables

```markdown
---

| Name | Role |
|------|------|
| Sam  | Writer |
| Alex | Editor |

The quick reference

You want You type
Heading # Title
Bold **text**
Italic *text*
Link [text](url)
Bullet list - item
Numbered list 1. item
Code `code`
Quote > quote
Image ![alt](url)

That is 95% of daily Markdown. Everything else — footnotes, task lists (- [ ]), definition lists — you can learn as you need it.

Where you’ll meet Markdown in the wild

Once you know the syntax, you will start spotting it everywhere. GitHub README files, project documentation, and developer wikis are almost always written in Markdown. Reddit comments, Discord messages, and Slack posts support Markdown-style formatting for bold, italics, and code — the same **bold** and `code` you use in the cheat sheet above. Note-taking apps like Obsidian, Notion (in its Markdown import mode), and Joplin store your notes as plain .md files, which means your notes stay portable: switch apps and your formatting survives. Blog platforms from Ghost to static site generators like Hugo render Markdown directly, so a single source file can become a blog post, a PDF handout, and a web page without reformatting.

Advertisement

The export workflow: from Markdown to a published page

Writing in Markdown is only half the story. The real power is how easily it converts to other formats.

To HTML (for websites and blogs): paste your Markdown into a Markdown-to-HTML converter and copy the resulting HTML. Headings become <h1> tags, links become <a> tags, code blocks get proper <pre> formatting. This is exactly how blog content moves from a writer’s draft to a published page — and the same tool converts HTML back to Markdown when you need to rescue content from a web page.

To PDF: most Markdown editors include an export or print-to-PDF option, which is perfect for resumes, guides, and documentation handouts.

To Word or slides: tools like Pandoc (free, command-line) convert Markdown to .docx, PowerPoint, ePub, and dozens of other formats — one source document, infinite outputs.

A practical workflow that works: draft everything in Markdown in a free online editor (no formatting rabbit holes), convert to HTML when it is time to publish, and keep the original .md file as your permanent, readable archive. Writers call this “separating content from presentation” — you focus on words now and styling later, and the same text publishes to any platform.

Frequently asked questions

What is Markdown and why should I use it?

Markdown is a plain-text formatting language that uses simple symbols like # for headings and * for bold. It is fast, distraction-free, readable everywhere, and converts cleanly to HTML, PDFs, and documents — which is why writers and developers both love it.

Where can I practice Markdown online for free?

Any free online markdown editor works — open one, type in the left pane, and watch the formatted preview appear live. Try the DollarWise markdown editor: it runs entirely in your browser with no account needed.

How do I convert Markdown to HTML?

Paste your Markdown into a Markdown-to-HTML converter and copy the resulting HTML. This is how blog posts written in Markdown get published on the web — the converter turns your # headings into <h1> tags automatically.

Is Markdown hard to learn?

No — the basics take about 15 minutes. Headings, bold, italics, links, lists, and code cover 95% of what most people need, and everything after that is optional.

Advertisement
Written by the DollarWise team

We turn confusing money topics into plain-English guides for beginners. Every article is written to be actionable on day one — no jargon, no hype, no sales pitch.