Sonntag, 16. November 2025
Best Practices für Bilder in Markdown
Screenshots und Diagramme landen schnell in Markdown. Spätestens auf Social Media oder in Folien zeigen sich Schwächen. Mit einer festen Checkliste bleibt die Qualität konstant.
- Beschreibe den Nutzen des Bildes statt Farbwerte.
- Unter 140 Zeichen bleiben und Formulierungen wie „Bild von…“ vermeiden.
- Wichtige Kennzahlen nennen, damit Text-Only-Leser:innen den Punkt verstehen.
- Datei mit TinyPNG/ImageOptim komprimieren oder in Markdown2Image direkt in 2× exportieren.
- In Directus, S3 oder dem Markdown2Image-CDN ablegen und die kanonische URL sichern.
- Dateiname, Alt-Text und Veröffentlichungsdatum in einem gemeinsamen Sheet pflegen.
- Markdown einfügen und Format wählen: Thread, Deck oder Mobile.
- Preset auswählen, anschließend Typografie, Abstände und Farben anpassen.
- PNG/SVG/WebP exportieren und den Embed-Code für README oder CMS nutzen.
- PNG direkt auf Twitter/LinkedIn teilen und auf den Artikel verlinken.
- Für Präsentationen das SVG verwenden, damit Kanten scharf bleiben.
- In Newslettern kurze Captions ergänzen, um Kontext zu liefern.
So bleibt Markdown sauber und das Bild sieht aus wie von der Designabteilung.