DocsWrite

Writing in the editor

Blocks that render in every inbox, text alignment, personalisation, one-click polls, previews and test sends.

The editor is deliberately constrained: every block it offers renders reliably in Gmail, Apple Mail and Outlook, as table-based HTML with a plain-text version alongside. What you write is what arrives.

Blocks

Type / to insert a block and keep typing to filter the list, or hover a block and press the + in the margin to add one below it. Drag the grip next to it to move a block.

Editor blocks
GroupBlocks
TextText, Heading, Subheading, Bulleted list, Numbered list, Quote, Code block
MediaImage, 2 columns, 3 columns, Image + text, Divider (• • •), Horizontal line
EmailButton, Poll, Subscribe button, Personalize
AIAsk AI, Continue writing, Draft a full issue (when AI assist is set up)
  • Button takes a label (“Read more” until you change it) and a link, and can be aligned left, centre or right.
  • Subscribe button links to your hosted signup page, which is handy when issues get forwarded.
  • Personalize inserts a merge field such as the reader's first name. See Personalisation.

Formatting

Select text to get the formatting bubble: bold, italic, inline code, links, heading, subheading, quote and alignment. Links must be https:// or mailto:, and you edit them right in the bubble. When AI writing help is on, the bubble also has Ask AI.

Keyboard shortcuts
ShortcutDoes
⌘ BBold
⌘ IItalic
⌘ EInline code
⌘ KAdd or edit a link
⇧ ⌘ L / E / RAlign left, centre or right
⇧ ⌘ 8 / 7Bulleted or numbered list
⇧ ⌘ BQuote
⌘ JAsk AI (when AI assist is set up)
⌘ SSave now (drafts also save as you type)
⌘ /Show every shortcut
/Insert a block

On Windows and Linux use Ctrl instead of ⌘.

Text alignment

Paragraphs and headings can be aligned left, centre or right from the bubble or the toolbar, and the alignment is kept in the email itself, so it looks the same in the inbox. Buttons align the same way. Lists and code blocks always stay left aligned, because many email clients render centred lists badly.

Images and columns

  • Upload, drag in or paste PNG, JPEG, GIF or WebP images up to 5 MB, or link an https image URL.
  • Alt text starts as the file name; change it to describe the image for screen readers and for inboxes that block images. The review step flags images without it.
  • Add an optional caption of up to 300 characters under any image.
  • Columns come in four layouts: two equal, three equal, narrow and wide, or wide and narrow. Switch layout from the block's toolbar. Columns stack into one on phones and can't be nested.

Personalisation

Merge fields are replaced with each reader's details when the email is sent. They work in the body and the subject line. Add a fallback after a | for readers whose value is missing:

Text
Hi {{first_name|there}},

You're reading this at {{email}}. Your plan: {{plan|Free}}.
Built-in merge fields
FieldValue
emailThe reader's email address
nameTheir full name, as you have it
first_nameThe first word of the name
last_nameEverything after the first word
any custom fieldAny of your custom fields, by key

Polls

A poll asks one question with two to five answers. Readers vote with a single click in the email, with no form and no sign-in, and see the live results.

  • Each answer is a link. The vote is recorded by the page it opens, not by the click itself, so security scanners that follow links don't cast votes.
  • One vote per reader. Voting again changes the answer.
  • Choose when it closes: never, or 1 day, 3 days, 1 week or 30 days after sending. You can also close or reopen it by hand from the campaign report.
  • Results appear in the campaign report. Votes from test sends and draft previews don't count. Each vote can also fire a poll.voted webhook.

Preview and test sends

Switch between Write and Preview at the top of the editor. The preview renders the real email with a real subscriber's merge values.

  • Desktop, Mobile and Plain text views.
  • A dark mode toggle that approximates how Gmail and Outlook invert colours.
  • Send a test to any address. The subject gets a [Test] prefix and merge fields use a sample reader, Alex Reader. Up to 30 tests an hour per newsletter.

Share a draft

Need a second pair of eyes? Create a private preview link from the editor and send it to anyone, with no account needed. You can turn the link off at any time.

Writing from code

Campaigns can also be created from Markdown through the REST API, including buttons and merge fields.

newsletter.sh

Newsletters on your own sending account. Invite-only, sent through Amazon SES or the provider you already use.

© 2026 newsletter.sh