How to Write a New Blog Post?

First Steps

1. Copy the _example-post folder
2. Rename it e.g. my-new-article – no spaces/umlauts (becomes the post's URL)
3. Replace hero.png with your title image. Requirements: min. 1600 px width. (Better too large than too small) Allowed: .png, .jpg, .jpeg, .webp
4. Open post.md and fill in the metadata (see below)
5. Additional images go in the /images subfolder. Embed with ![Alt-Text](./images/file.jpg). See tree example below

Choosing the Right Metadata (Title, Description etc.)

If there's even the slightest chance this post should rank on Google, the following things must be followed:

Examples of Good Descriptions

• "How to plan a UX interview step by step – including question catalog and downloadable templates."
• "A practical guide for alt texts: What belongs in them, what doesn't – with examples to copy."

Images in the Post

Image of a tree as an example:

If you want to display the image smaller or customize it otherwise, you must embed it as HTML. Example:

The path to the image remains the same for both methods: ./images/baum.jpg

How to Write a Good Image Description (Alt Text)?

• Keep it short (1–2 sentences).
• Mention central information (why this image?).
• Don't write "Image of …".
• Name the medium if relevant (logo, illustration, screenshot).
• Don't duplicate what's directly next to it in the text.
• End with a period.

Alt Text: Examples

• Good: "Branch of a beech tree with fresh, green leaves in backlight."
• Good (Logo): "ACME logo: Large A in a circle."
• Bad: "Image of tree" (too vague) / "Branch of a beech tree … (see text above)" (duplicates)

Source: Harvard University

Writing Content-Wise Good Posts

• A clear question/thesis answered right at the beginning.
• Sections with subheadings (H2/H3) for scannability.
• Short paragraphs, lists, examples.
• Internal links to relevant articles.
• Conclusion/CTA at the end: What should the reader do next?