Adding Images and Media

Writing & Content

Images live in /media/, and Nano CMS handles the fiddly parts for you.

Uploading

Upload through the Media manager. Every file is re-encoded through the image library on the way in - which strips any payload hidden in the file - and a thumbnail is generated automatically for use on cards. You can organise uploads into folders.

Using an image in a post

  • Set it as the post's hero image in the editor (with alt text), or
  • Drop it inline with Markdown: ![Descriptive alt text](2026-05-12-a4f8b2.jpg)

Always write real alt text. It's what screen readers announce and what search engines read, and Nano CMS falls back to the post title only if you leave it blank.

Embedding video

Raw <iframe> HTML is stripped by safe mode, so use a shortcode instead:

Each expands to a responsive, privacy-respecting embed after the Markdown is rendered.