Colocated Assets

Files in the content/ directory whose extension does not match content.formats (default: md, html) are automatically copied to the output, preserving their path:

content/about/
  index.md              -> processed as content
  diagram.svg           -> _site/about/diagram.svg
  hero.png              -> _site/about/hero.png

This enables colocating assets with the content that uses them:

---
title: "About Us"
---

# About Us

![Team photo](hero.png)

{% inline "./diagram.svg" %}

What Gets Copied

All files in the content directory are copied except:

  • Files matching content.formats (those are content pages)
  • _data.yaml / _data.yml (cascade data files)
  • Dot-prefixed files (.DS_Store, .gitkeep, etc.)