Switching from Medium

Import your Medium export (posts, drafts, images and canonical links) into a blog you own.

Medium lets you download everything you wrote. Mezaic reads that archive and turns each story into a Markdown post on your own site, keeping titles, formatting, images, dates and the original URL as a canonical link.

1. Download your Medium archive

  1. On Medium, open Settings → Security and apps → Download your information.
  2. Medium emails you a ZIP. It contains posts/*.html and drafts/*.html.

You can also import a single .html or .md file.

2. Import

  1. Open Publish → Blog and click Import.
  2. Drop the ZIP (up to 64 MB / 500 posts) or a single file.
  3. Review the preview. Stories with the same title or canonical URL as an existing post are marked as duplicates; the header shows how many posts your plan still allows.
  4. Choose your options and click Import.

Options

Option What it does
Keep publish status and dates Published stories stay published with their original date. Off: everything is imported as a draft.
Download images Images referenced in the stories are copied into your storage (within your quota) and the first one becomes the cover. Off: images keep pointing at Medium.
Keep canonical URLs Sets each post’s canonical link to the Medium URL (or the “Originally published at” address) so search engines do not treat the copy as duplicate content. Turn it off once you consider Mezaic the original.

Large batches (more than 8 posts or 12 images) run in the background; the page shows progress and you can keep working.

Imported posts never email your subscribers.

What is converted

  • Titles and subtitles, headings (Medium’s H3/H4 become H2/H3), bold and italic, quotes, lists.
  • Code blocks, with syntax highlighting on your site.
  • Images and captions, as figures.
  • Embeds (YouTube, Vimeo, Spotify, CodePen, X) as privacy-friendly click-to-load players.
  • Link cards (“mixtape” cards) as plain links.

Medium’s claps, comments and reading lists have no equivalent and are not imported.

After importing

  • Skim each post in the editor; long stories occasionally need a heading or image nudged.
  • Add tags so the archive page and search markup are useful.
  • Point your readers at your new RSS feed (/feed.xml) and set up Subscribers so the next post reaches them by email.
  • Connect a custom domain. If you used Medium’s custom-domain feature, redirecting the old domain to your new site preserves most of your traffic.

Troubleshooting

“That doesn’t look like a Medium export.” The file must be the ZIP Medium sent you (containing a posts folder) or a single .html / .md file.

Images missing after import. Medium sometimes serves images behind expiring links. Re-run the import for those stories with Download images on, or add the pictures by hand in the editor.