The editor

The editor is where you'll spend most of your time. It's designed to stay out of your way: a clean writing surface with the formatting you need and nothing you don't.

Two ways to write

You can write in two modes and switch between them freely:

• WYSIWYG — a rich visual editor where formatting appears as you type. Great for most posts.
• Markdown — a plain-text mode with syntax highlighting for people who'd rather type than click. See Markdown for the full reference.

Both modes produce the same underlying post, so use whichever feels right for the moment.

Formatting basics

The editor supports the building blocks of a good article:

• Headings (use them to structure your post — they also help SEO).
• Bold, italic, and inline code.
• Bulleted and numbered lists.
• Blockquotes and horizontal dividers.
• Links, with sensible defaults for external URLs.

Rich content

Beyond text, you can add:

• Images by dragging, dropping, or pasting them directly. They're optimized automatically and you can add alt text — see Images and media.
• Tables for structured data, editable cell by cell.
• Embeds for things like videos and other media.
• Code blocks with syntax highlighting, ideal for technical posts.

Staying organized

Posts save as you work, so you won't lose progress. You can keep drafts unpublished as long as you like — writing is free, and only deploying requires an active plan. When a post is ready, publishing it makes it part of your next deploy.

Tips for clean posts

• Lead with a short intro paragraph, then break the body into sections with ## headings.
• Keep paragraphs short; readers skim.
• Use lists for steps and comparisons.
• Add alt text to every image — it helps accessibility and SEO.

Collaborating

If you've invited editors to your blog, they can write and edit alongside you. Roles control who can publish versus who can only draft — see Team and roles.

When your post looks the way you want, move on to Deploying your blog to ship it. Stuck on something? Email [email protected].