Skip to content

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 (called Posts on a Blog website) and click New post.

Posts work in both Personal and Blog presentations. To give the site a standalone publication header and posts-first homepage, choose Blog in Appearance. This does not change article URLs, editing features or syntax highlighting. Choose List or Cards there; edit publication text and optional author attribution in Site details.

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 saves drafts after a pause in typing, once they have a title. A local backup can also recover unsaved text on the same browser when browser storage is available.
  • 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:

markdown
```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.

Saving and recovery

The status at the top tells you when the post is Saving…, Saved or has Unsaved changes. You can also click Save draft or use the save shortcut.

When you leave a draft with a title, Mezaic saves it first. If that save fails, the editor stays open so you can retry. Text entered while a save is in progress is kept and remains marked as unsaved until the next save completes.

If a local backup is available when you return, choose Restore to recover it or Discard to keep the saved version. Published and scheduled posts do not autosave changes to your live site; save those changes explicitly. Leaving with unsaved changes asks for confirmation.

Publishing

The sticky bar at the top holds the status and the main action:

Status Meaning
Draft Visible to its writer, the website owner and editors. Share the preview link (Advanced) to show someone; it works while the post is unpublished and carries noindex.
In review A writer submitted this post for the owner or an editor to review. It stays off the public website until published.
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: when the post goes live, readers subscribed to New posts get a short email: the title, a line saying a new post is up on your blog, the cover and excerpt, and a Read the post button that brings them to your site (so the read shows in your analytics). A post is never emailed twice, and imported posts never email anyone. See Subscribers.

Deleting and the trash

Deleting a post moves it to the Trash tab on the Blog page rather than removing it straight away. While it is there it is hidden from your site, feed and sitemap and does not count towards your plan.

  • Restore brings the post back with the status it had (published posts go live again, drafts stay drafts). If another post has taken the same address in the meantime, the restored one gets a short suffix on its slug.
  • Delete permanently removes it right away.
  • Anything left in the trash is permanently deleted 15 days after the day it was deleted. A daily clean-up handles this, so treat the trash as a safety net, not a place to keep posts.

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 10 MB, and within your storage quota; see Billing for usage. Large photos are fine: anything wider than 1600px is resized on upload and camera metadata (including location) is removed, so the stored file is usually far smaller than the one you picked.

The preview looks different from the site. The preview uses your site’s typography but not your theme colours; everything else is identical.

Write with other authors

Plans with Blog team let you invite writers and editors using their existing Mezaic accounts. Writers submit drafts for review; editors can publish and schedule. Each article keeps its own public author credit. See Write with a blog team.