Blog Images
Store your blog post images here with this structure:
assets/images/
└── YYYY/ # Year
└── MM/ # Month
└── image-name.png
Example
assets/images/
└── 2026/
└── 02/
├── distributed-systems-diagram.png
├── architecture-overview.jpg
└── code-screenshot.png
Best Practices
- Organize by date: Use YYYY/MM/ structure
- Descriptive names: Use kebab-case (my-image-name.png)
- Optimize: Compress images before adding
- Format: Prefer PNG for diagrams, JPG for photos
- Size: Keep under 500KB when possible
- Alt text: Always add in Markdown
Usage in Posts

Image Optimization Tools
- TinyPNG - Online compression
- ImageOptim - Mac app
- Squoosh - Web app
- CLI:
imagemagick,optipng,jpegoptim
Tips
- Use version control for images too
- Don’t commit huge files (> 1MB)
- Consider external hosting for very large images
- Reference images with absolute paths from site root