Everything a Blogger Needs to Know About Markdown

You’ve fought the formatting toolbar. You’ve copy-pasted between WordPress and Google Docs, watching your headings and code blocks fall apart. You’ve wondered what happens to your content if the platform you’re using shuts down — or just changes its editor again.

Markdown solves all of this. It’s a lightweight syntax you can learn in ten minutes, readable as plain text, and portable across every platform. This guide covers everything from basic formatting to advanced features like code highlighting, math, tables, and frontmatter metadata.

#Why Markdown for Blogging?

If you’re wondering why markdown matters for writers, here’s the short version.

#It’s Portable

A markdown file works in every text editor on every operating system. Your blog posts aren’t locked in a proprietary format — they’re plain text files that will be readable decades from now.

#It’s Focused

Markdown keeps you in writing mode. No formatting toolbar, no style panels, no drag-and-drop blocks. Just text with lightweight syntax.

#It’s Universal

GitHub, Reddit, Discord, Notion, Obsidian, Slack — markdown is everywhere. Learn it once, use it everywhere.

#It Separates Content From Presentation

Your markdown file contains your words and structure. How it looks on your website is handled by your publishing tool. Change your blog’s design without touching your content.

#Basic Syntax

#Headings

# Heading 1 (Post Title)
## Heading 2 (Section)
### Heading 3 (Subsection)
#### Heading 4 (Detail)

Use one H1 per post (your title). Structure the rest with H2s and H3s. Don’t skip levels — go H1 → H2 → H3, not H1 → H3.

#Paragraphs

Just write. Separate paragraphs with a blank line.

This is the first paragraph. It can be as long as you want.
 
This is the second paragraph. The blank line between them creates the separation.

#Emphasis

*italic text* or _italic text_
**bold text** or __bold text__
***bold and italic***
~~strikethrough~~

Use bold sparingly. When everything is emphasized, nothing is.

#Links

[Link text](https://example.com)
[Link with title](https://example.com "Title text")

For blog posts, use descriptive link text. “Read the documentation” is better than “click here.”

#Images

![Alt text describing the image](path/to/image.jpg)

Alt text matters for accessibility and SEO. Describe what the image shows, not just “image” or “screenshot.”

#Lists

Unordered:
- First item
- Second item
  - Nested item
  - Another nested item
- Third item
 
Ordered:
1. First step
2. Second step
3. Third step

#Blockquotes

> This is a blockquote. Use it for quotes,
> callouts, or to set text apart from the main flow.
>
> Multiple paragraphs in a quote need the > on blank lines too.

#Horizontal Rules

---

Use sparingly. A heading is usually better for separating sections.

#Intermediate Syntax

#Code

Inline code uses single backticks:

Use the `console.log()` function for debugging.

Code blocks use triple backticks with an optional language identifier:

```javascript
function greet(name) {
  return `Hello, ${name}`;
}
```

On FolderPress, code blocks are syntax-highlighted with Shiki, supporting 100+ languages — see features for developers for details. Always specify the language for proper highlighting.

#Tables

| Feature | Free | Pro |
|---------|------|-----|
| Custom domain | No | Yes |
| Newsletter | Yes | Yes |
| Analytics | Basic | Advanced |

Tables work best for comparisons and structured data. Don’t use them for layout.

#Task Lists

- [x] Write the first draft
- [x] Add code examples
- [ ] Review and edit
- [ ] Publish

Task lists render as checkboxes. Useful for progress updates and to-do lists in blog posts.

#Footnotes

This claim needs a source[^1].
 
[^1]: Source: The Original Study, 2024.

Footnotes are great for citations, asides, and tangential details that would interrupt the flow.

#Advanced Features

#Frontmatter

Frontmatter is YAML metadata at the top of your markdown file:

---
published_at: 2026-02-15
description: "An optional summary for search engines and social cards."
---
 
Your post content starts here...

On FolderPress, frontmatter controls:

Title comes from the first H1 heading in your document, then the filename. Frontmatter is optional. FolderPress uses sensible defaults when it’s missing.

#Math (KaTeX)

Inline math uses single dollar signs:

The equation $E = mc^2$ changed physics.

Display math uses double dollar signs:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

FolderPress renders math with KaTeX — fast, accurate, and no client-side JavaScript required.

#Slide Decks

On FolderPress, drop a markdown file in your decks/ folder to create a presentation. Use --- (three dashes on a blank line) as the slide separator — the same convention used by Marp and reveal.js:

# Talk Title
 
Your name, date, event
 
---
 
## First Point
 
- Key insight one
- Key insight two
 
---
 
## Second Point
 
With more detail here.

One file format for blog posts, documentation, and presentations.

#Writing Tips for Bloggers

#Structure for Scanning

Most readers scan before they read. Use clear headings, short paragraphs, lists for related points, and bold for key terms (sparingly).

#One Idea Per Post

A focused post on one topic is more useful (and more shareable) than a sprawling post that covers everything. If your post has more than four H2 sections, consider splitting it.

#Use .draft.md for Works in Progress

On FolderPress, any file ending in .draft.md stays unpublished. Write freely, iterate, and rename to .md when you’re ready to go live.

#Your Folder Structure Is Your URL Structure

Organize your Dropbox folder the way you want your site to read. A file at posts/2026/my-post.md becomes /posts/2026/my-post. No slug configuration needed.

#Add Metadata

Take thirty seconds to add frontmatter with a title. FolderPress auto-generates descriptions from your post content — write a strong opening paragraph and your SEO and social sharing are handled.

For more on the writing workflow and advanced markdown tips for bloggers, keep reading.

#Markdown Editors for Blogging

Any text editor works for markdown. Here are some that bloggers particularly like:

The best editor is the one that disappears when you write. Try a few and keep what feels right.

#Getting Started With FolderPress

Ready to start a markdown blog?

1. Sign up at FolderPress
2. Connect your Dropbox
3. Create a site
4. Open the folder in your editor of choice
5. Write a markdown file and save it

Your first post is live in under two minutes. No configuration, no theme selection, no plugin installation. Save is publish.