Zum Inhalt springen
Zurück zum Blog
Freitag, 6. November 2026

GitHub-README als Bild: Eine PNG-Karte für den nächsten Release

Importiere eine öffentliche GitHub-README, kürze sie auf die wichtigsten Änderungen und teile die PNG-Karte mit einem Link zur Quelle.

GitHub-README als Bild: Eine PNG-Karte für den nächsten Release

Für eine Release-Ankündigung reichen oft wenige Zeilen aus der README. Sie erklären, wofür das Projekt gedacht ist und was sich geändert hat. Lade die Datei über die Repository-URL in den GitHub-README-Bildkonverter und exportiere den passenden Ausschnitt als PNG.

README von GitHub laden

  1. Öffne ein öffentliches Repository und kopiere die Adresse seiner Startseite. Mit octocat/Hello-World kannst du den Import testen.
  2. Füge die Adresse ein, klicke auf README abrufen und kontrolliere den Inhalt im Editor.
  3. Lass den Projektnamen, die Versionsnummer und die wichtigsten Änderungen stehen. Bearbeite die Arbeitskopie im Konverter.
  4. Prüfe die Vorschau in der gewünschten Breite, wähle PNG in den Ausgabeeinstellungen und lade das Bild herunter.

Falls der Import scheitert, öffne das Repository ohne Anmeldung und prüfe, ob eine README sichtbar ist. Für eine bestimmte Branch-Version oder eine lokale Datei kannst du den freigegebenen Ausschnitt in den Markdown-Konverter einfügen.

Einen Release-Ausschnitt ausprobieren

Nach dem Test mit dem öffentlichen Repository haben wir den Editorinhalt durch dieses eigene Beispiel ersetzt. Kopiere es in den Editor, um das Layout nachzustellen. Prüfe vor dem Export des bearbeiteten Ausschnitts in den Ausgabeeinstellungen den Namen und das Datum.

# Trail Notes 1.2

A small command-line tool for organizing field notes.

## What's new

- Group notes by trip.
- Search by date or tag.
- Export a trip summary as Markdown.

**Quick start:** Open a notes folder, then choose a trip.

PNG für Trail Notes 1.2 mit drei Änderungen und einem kurzen Einstiegshinweis

Vollständiges PNG öffnen. Der Exportdienst der Website hat das Bild aus der Live-Vorschau des README-Werkzeugs erzeugt. Die Breite betrug 800 px, der Ausgabefaktor 2×.

Badges, Bilder und Umbrüche prüfen

Fehlende Badges oder Screenshots fallen in der Vorschau auf. Ein relativer Pfad wie docs/demo.png hängt vom Repository und vom Speicherort der README ab. Lädt das Bild nicht, ersetze ihn durch eine öffentlich erreichbare Bildadresse für die angekündigte Version. Eine Karte aus Text und kurzen Stichpunkten funktioniert ebenfalls.

Öffne das PNG in der geplanten Anzeigegröße. Kürze lange Befehle und breite Tabellen, wenn sie die Karte schwer lesbar machen. Die vollständigen Anleitungen bleiben auf GitHub zum Kopieren verfügbar.

Bild und Quelle zusammen teilen

Setze den Repository- oder Release-Link neben das Bild. Bei einer festen Version eignet sich die Release-Seite oder ein permanenter README-Link für den jeweiligen Commit. Eine kurze Bildunterschrift hält die Ankündigung auch ohne geladenes Bild verständlich. Danach kannst du eine öffentliche README in ein Bild umwandeln.