Media

Work with images and PDFs without breaking your notes

Images and PDFs can live beside your Markdown, appear in the sidebar, and resolve through the active storage adapter when needed.

5 min read

Keep references canonical

Moonstone stores vault-relative or bare-filename references instead of polluting your Markdown with provider URLs.

That keeps notes cleaner and makes them easier to move between adapters over time.

Use a media folder when it helps

You can choose a dedicated media folder per vault, or keep uploads at the vault root if that suits your workflow better.

Insert assets from the sidebar

Image and PDF assets appear in the sidebar so you can quickly insert them into the active note without hunting through file pickers.