Willkommen im Hidden-Gems-Blog!

Michael Specht·18.01.2026

Informatiklehrer am Gymnasium Steglitz und Organisator des »Hidden Gems«-Wettbewerbs.

AnleitungBlog

Willkommen zu unserem Blog für den »Hidden Gems«-Wettbewerb! Hier veröffentlichen Teilnehmerinnen und Teilnehmer ihre Beiträge: spannende Analysen, Strategieskizzen, Erklärungen zu Algorithmen oder Erfahrungsberichte aus dem Wettbewerb.

Wir wollen, dass ihr nicht nur programmiert — ihr sollt auch kommunizieren, erklären und reflektieren, was ihr gemacht habt. Dieser Blog ist ein Ort dafür.

Das Ziel dieses Blogs ist es, eure Ideen sichtbar zu machen. Jeder Beitrag ist eine Chance, etwas Interessantes zu zeigen – sei es ein kreativer Lösungsweg, eine technische Herausforderung oder eine besondere Erkenntnis aus eurem Projekt. Du möchtest selbst einen Artikel schreiben? Super! In diesem Beitrag erfährst du, wie du einen Beitrag schreiben und ihn hier veröffentlichen kannst — ganz egal, ob du technische Details zeigen oder deine Gedanken teilen willst.

Schreibe deinen eigenen Artikel

Hier ist eine Schritt-für-Schritt-Anleitung, wie du deinen eigenen Artikel für den »Hidden Gems«-Blog erstellen kannst.

Repository forken und klonen

Öffne das »Hidden Gems«-Blog-Repository unter https://github.com/specht/hidden-gems-blog und lege einen Fork an. Klone deinen Fork anschließend auf deinen lokalen Rechner.

Erstelle in deinem lokalen Repository im Unterverzeichnis contentein neues Verzeichnis mit dem Namen deines Artikels im Format YYYY-MM-DD-titel-deines-artikels. Erstelle darin eine Datei namens index.md.

Artikel schreiben

Schreibe deinen Artikel in der index.md-Datei. Du kannst Markdown verwenden, um deinen Text zu formatieren, Bilder einzufügen und Links hinzuzufügen.

Front Matter

Gib oben in der index.md-Datei die Metadaten deines Artikels im YAML-Format an. Hier ist ein Beispiel:

---
author: Michael Specht
author_bio: >
  Informatiklehrer am Gymnasium Steglitz und
  Organisator des »Hidden Gems«-Wettbewerbs.
author_image: specht.jpg
tags: ["Anleitung", "Blog"]
---

Das Datum wird automatisch aus dem Verzeichnisnamen übernommen.

Markdown

• Überschriften: Verwende # für Hauptüberschriften, ## für Unterüberschriften usw.
• Fett und Kursiv: Verwende **Text** für fett und *Text* für kursiv.
• Listen: Verwende - oder * für ungeordnete Listen und 1., 2. für geordnete Listen.
• Links: Füge Links mit [Link-Text](URL) ein.
• Bilder: Füge Bilder mit ![Alt-Text](Pfad-zum-Bild) ein (achte darauf, dass sich die Bilder im gleichen Verzeichnis wie deine index.md-Datei befinden oder verwende relative Pfade).

HTML

Du kannst auch HTML-Tags verwenden, um deinen Artikel weiter zu gestalten, z. B. mit Tabellen:

Code

Du kannst Codeblöcke mit dreifachen Backticks (```) erstellen. Zum Beispiel:

def hallo_welt():
    print("Hallo, Welt!")

Du kannst auch Code aus externen Dateien einbinden, indem du den Pfad zur Datei angibst:

1
2
3
4
5
6

#include <iostream>

int main() {
    std::cout << "Hello, World!\n";
    return 0;
}

LATEX-Code

Für mathematische Formeln kannst du LaTeX verwenden. Inline-Formeln kannst du mit $...$ einfügen (diese erscheinen dann direkt im Fließtext: $E=mc^2$), und für abgesetzte Formeln verwende $$...$$. Zum Beispiel:

Alerts

Du kannst verschiedene Arten von Alerts verwenden, um wichtige Informationen hervorzuheben:

Icons

Falls du Icons brauchst, kannst du Bootstrap Icons verwenden:

Änderungen committen und pushen

Nachdem du deinen Artikel geschrieben hast, füge die neuen Dateien zu deinem Git-Repository hinzu, committe deine Änderungen und pushe sie zu deinem Fork auf GitHub:

git add .
git commit -m "Neuer Artikel: Titel deines Artikels"
git push origin main

Pull Request erstellen

Gehe zu deinem Fork auf GitHub und erstelle einen Pull Request, um deine Änderungen zum Haupt-Repository beizutragen. Beschreibe kurz, worum es in deinem Artikel geht. Wir werden deinen Beitrag überprüfen und ihn dann in den Blog aufnehmen.

Previews

Um ein Preview deines Artikels zu sehen, kannst du einfach den lokalen Preview-Server starten:

gem install rouge webrick kramdown kramdown-parser-gfm # nur beim ersten Mal nötig
ruby server.rb [pfad-zu-deinem-artikel]

Du kannst dann deinen Artikel im Browser unter http://localhost:4000 ansehen.

Tipps für gute Beiträge

• Wähle einen klaren Titel und aussagekräftige Überschriften.
• Achte auf lesbare Struktur (Absätze, Listen, Code-Blöcke).
• Wenn du Code teilst, nutze korrekte Markdown-Syntax für Highlighting.
• Beschreibe nicht nur was, sondern warum du etwas so umgesetzt hast.