From 26a53c5cf111c3d1fd55c84045753c6192130c0c Mon Sep 17 00:00:00 2001
From: Remo Senekowitsch <remo@buenzli.dev>
Date: Mon, 14 Apr 2025 23:13:47 +0200
Subject: [PATCH] Document recommended way to include images

---
 README.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4e99a71dc..3f07dc8ae 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,12 @@ Code of Conduct, see `CODE_OF_CONDUCT.md` for more.
 
 ### Writing a new blog post
 
-When writing a new blog post, keep in mind the file headers:
+If you want to include images in your post, please store them in the repository.
+You can store your main blog post in `content/<some-slug>/index.md`.
+Images go into the same directory: `content/<some-slug>/my_image.png`.
+Now you can reference that image with a simple relative path: `![alt text](my_image.png)`.
+
+Here is an example of the front matter format:
 ```md
 +++
 path = "2015/03/15/some-slug"