Blog
Write in Markdown with live preview, code highlighting, images and embeds; schedule posts, control search appearance and publish an RSS feed.
The blog is for anything longer than a paragraph. Posts are written in Markdown, rendered by Mezaic with syntax-highlighted code, figures and privacy-friendly embeds, and published with proper search and social markup.
Open Publish → Blog and click New post.
The editor
- Title at the top; the URL slug is generated from it and can be changed under Advanced before the post is published.
- Toolbar for bold, italic, links, headings, lists, quotes, code and images, with shortcuts ⌘B, ⌘I, ⌘K (link) and ⌘S (save).
- Split view shows a live preview beside the text that scrolls in step with it. The preview is exactly what your site will render.
- Focus mode hides everything but the text.
- Images: paste or drop an image anywhere in the body and it uploads and inserts itself. Alt text you write in the Markdown becomes the caption.
- Autosave keeps drafts as you type and recovers unsaved text if the tab closes.
- Markdown help opens a cheatsheet; the full reference is in Markdown.
Code blocks
Fenced code with a language name is highlighted on the server, in light and dark themes. Add a title to show a filename:
```go title=main.go
fmt.Println("hello")
```Every code block gets a Copy button on your site.
Embeds
Paste a YouTube, Vimeo, Spotify, SoundCloud, CodePen or X link on its own line and it becomes a click-to-load player. Nothing is fetched from the provider until the reader presses play, so your pages stay fast and private.
Callouts and tables of contents
> [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] and [!CAUTION] quotes render as coloured callouts. Posts with three or more ## headings get an automatic table of contents.
Publishing
The sticky bar at the top holds the status and the main action:
| Status | Meaning |
|---|---|
| Draft | Only you can see it. Share the preview link (Advanced) to show someone; it works while the post is unpublished and carries noindex. |
| Scheduled | Choose a date and time under Publishing; the post goes live automatically within a minute of that time. |
| Published | Live at /blog/your-slug, in the archive, in the feed and in the sitemap. Unpublish returns it to a draft. |
Cover, tags and excerpt
- Cover: the image used at the top of the post and as the social share image. Counts against storage.
- Tags: clickable on the archive page and included in search markup.
- Excerpt: the summary shown in lists and, unless overridden, in search results.
Search appearance
Toggle Custom search appearance to set your own title and description for search engines. Empty values fall back to the post title and excerpt. See SEO and structured data.
Advanced
- Canonical URL: if the post first appeared elsewhere (Medium, a company blog), paste the original address so search engines credit it properly. Imports from Medium set this for you.
- Email subscribers: send the post to readers subscribed to New posts when it is published. A post is never emailed twice, and imported posts never email anyone. See Subscribers.
RSS feed
Your site publishes a full-content feed at /feed.xml. Point readers and services such as Feedly, Mailbrew or dlvr.it at it.
Limits
The number of posts depends on your plan; drafts count. See Plan limits. The blog itself is a plan feature; on a plan without it the Blog tab is hidden and existing posts are kept until you upgrade.
Troubleshooting
Scheduled post did not appear. Scheduling is in your local time; check the date on the post. Posts are published by a background job that runs every minute.
Image failed to upload. Images must be JPEG, PNG, GIF or WebP between 1 KB and 5 MB, and within your storage quota; see Billing for usage.
The preview looks different from the site. The preview uses your site’s typography but not your theme colours; everything else is identical.