Inhaltsverzeichnis

Hugo für Einsteiger: Eigene Website mit Markdown und Git #

Du willst deinen Blog oder deine Projektseite mit Markdown betreiben – ohne Datenbank, ohne Admin-Oberfläche, aber mit voller Kontrolle? Dann ist Hugo der perfekte Generator für dich.

In diesem Beitrag zeige ich dir, wie du:

Hugo installierst
Ein minimales Projekt anlegst
Ein Theme als Git-Submodul einbindest
Markdown-Beiträge schreibst
Deine Seite lokal startest

Voraussetzungen #

Linux, macOS oder Windows (WSL)
Git installiert
Hugo installiert (am besten extended Version)

Installation (Ubuntu/Debian) #

sudo apt install hugo

Neues Hugo-Projekt anlegen #

hugo new site meinblog
cd meinblog
git init

Theme hinzufügen (hier: smol) #

git submodule add https://github.com/colorchestra/smol.git themes/smol

In deiner config.toml:

theme = "smol"

Ersten Beitrag erstellen #

hugo new posts/hallo-welt.md

Dann den Inhalt bearbeiten:

---
title: "Hallo Welt"
date: 2025-05-21
draft: false
---

Das ist mein erster Beitrag!

Seite lokal starten #

hugo server

Dann öffnen: http://localhost:1313

Seite generieren (für Deployment) #

hugo

Die fertige Seite liegt nun im public/-Verzeichnis. Du kannst sie einfach per FTP oder rsync auf deinen Webspace hochladen.

Git-Workflow mit Submodul #

Damit andere dein Repo inklusive Theme klonen können:

git clone --recurse-submodules https://example.com/your-repo.git

Falls schon geklont:

git submodule update --init --recursive

Bonus: Tipps #

Themes ohne SASS vermeiden, wenn du ältere Hugo-Versionen nutzt
static/ ist ideal für herunterladbare Dateien (z.B. PDFs)
Nutze archetypes/, um Standardbeiträge vorzubereiten
Mit baseURL und languageCode in config.toml gibst du das Zielsetup an

Fazit #

Mit Hugo + Git + Markdown betreibst du deine Seite effizient, schnell und portabel – ohne CMS-Ballast.

Viel Spaß beim Schreiben und Veröffentlichen!