Jekyll Anleitung für macOS

Eine leicht verständliche, ausführliche Anleitung – damit jede Person sicher mit Jekyll auf dem iMac loslegen kann.

1. Vorbereitung auf Deinem iMac

Terminal öffnen
Finder → Programme → Dienstprogramme → Terminal. Dort gibst du Textbefehle ein.
Ruby-Version prüfen
ruby -v – mindestens Version 2.7
Homebrew installieren
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Jekyll & Bundler installieren

Installieren
gem install --user-install bundler jekyll
Pfad ergänzen
export PATH="$HOME/.gem/ruby/3.x.x/bin:$PATH" in ~/.zshrc oder ~/.bash_profile
Testen
jekyll -v → sollte eine Versionsnummer anzeigen

3. Neues Blog-Projekt anlegen

In Dokumente wechseln
cd ~/Dokumente
Projekt erstellen
jekyll new mein-blog
Projekt öffnen
cd mein-blog

4. Lokalen Server starten

Startbefehl
bundle exec jekyll serve
Seite ansehen
http://localhost:4000
Live-Vorschau
Änderungen werden automatisch übernommen

5. Blog-Beiträge schreiben

Datei im richtigen Ordner anlegen
Jekyll erwartet deine Beiträge im Ordner _posts. Der Dateiname folgt dem Format:
Jahr-Monat-Tag-titel.md
Beispiel: 2025-08-07-mein-erster-beitrag.md
YAML-Frontmatter einfügen
Dieser sogenannte "Kopfbereich" steht ganz oben in der Datei und sieht so aus:
---
layout: post
title: "Mein erster Beitrag"
date: 2025-08-07 10:00:00 +0200
---
Inhalt schreiben mit Markdown
Darunter folgt dein Beitragstext. Jekyll nutzt Markdown – eine einfache Schreibweise für Formatierungen:
  • # Überschrift → große Überschrift
  • **fett**fetter Text
  • *kursiv*kursiver Text
  • - Listenpunkt → Aufzählung
Beitrag speichern
Speichere die Datei. Wenn dein Jekyll-Server läuft, kannst du sie direkt im Browser sehen.

6. Beiträge ansehen & den Server stoppen

Im Browser ansehen
http://localhost:4000/mein-erster-beitrag.html
Beenden
Strg + C im Terminal

7. Tipps für alle – leicht und zugänglich

Größere Schrift
Terminal → Einstellungen → Schriftgröße erhöhen
Dateien bearbeiten
TextEdit oder Visual Studio Code – einfache Textbearbeiter
Hilfe holen?
Kein Problem! Mach ein Foto vom Fehler, frag Freunde oder online

8. Weiterführende Links