Astro Starlight erklärt, Setup, Plugins, Grenzen und der Vergleich mit Docusaurus, VitePress und GitBook für technische Dokumentation.
Mehr erfahren
Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.
npm create astro@latest -- --template satnaing/astro-paper
cd mein-blog
npm install
npm run dev
src/content/posts/ ab. Unterordner werden Teil der URL. So bleibt auch ein großes Blog übersichtlich.
---
title: Mein erster Beitrag
pubDatetime: 2026-11-18T09:00:00Z
description: Kurzer Teaser für Liste und Suche
tags:
- astro
draft: false
---
Hier beginnt dein Text.
dist. Wie dieser Ordner aufgebaut ist, zeigt unser Artikel zur dist Ordner Struktur. Wird der Build zäh, hilft der Beitrag Astro Build langsam.
astro-paper.config.ts. Dort stehen Titel, Autor, Sprache und Zeitzone. Auch einzelne Features schaltest du hier an oder aus.
import { defineAstroPaperConfig } from "./src/types/config";
export default defineAstroPaperConfig({
site: {
url: "https://dein-blog.de/",
title: "Dein Blog",
author: "Dein Name",
lang: "de",
timezone: "Europe/Berlin",
},
features: {
lightAndDarkMode: true,
dynamicOgImage: true,
search: "pagefind",
toc: true,
},
});
Ein minimales, responsives, barrierefreies und SEO freundliches Astro Blog Theme
Astro Starlight erklärt, Setup, Plugins, Grenzen und der Vergleich mit Docusaurus, VitePress und GitBook für technische Dokumentation.
Mehr erfahren
Wir bauen schnelle, sichere und barrierefreie Websites mit Astro. Kurze Ladezeiten, saubere Technik und gute Bedienbarkeit für alle, so erfüllt eure Website die gesetzlichen Anforderungen und wird gleichzeitig besser gefunden. Jede Änderung prüfen automatisierte Tests, bevor sie live geht.
Ja. AstroPaper läuft auf Astro 7, TypeScript und Tailwind CSS 4 und wird laufend gepflegt. Der Maintainer Sat Naing zieht neue Astro Versionen zügig nach. Damit startest du ohne Umbau auf einem aktuellen Stand. Prüfe vor dem Start trotzdem die offenen Issues im Repo, damit du bekannte Stolpersteine kennst.
Ja. AstroPaper steht unter MIT Lizenz. Du darfst das Theme frei nutzen, verändern und auch für kommerzielle Projekte einsetzen. Pflicht ist nur, den Lizenzhinweis im Code zu behalten. Kosten entstehen höchstens für dein Hosting und die Zeit, die du in Anpassungen steckst.
AstroPaper hat rund 5.000 Sterne und über 1.000 Forks auf GitHub. Damit gehört es zu den drei bekanntesten freien Themes auf astro.build. Mehr Sterne hat dort nur Starlight, das offizielle Doku Werkzeug von Astro. Fuwari liegt bei den Sternen etwa gleichauf mit AstroPaper.
AstroPaper nutzt Astro 7 zusammen mit Tailwind CSS 4. Für MDX, RSS und Sitemap kommen die offiziellen Astro Integrationen zum Einsatz. Die Suche läuft über Pagefind, OG Bilder entstehen mit Satori. Das Setup passt damit gut zu modernen Astro Projekten und zu aktuellen Node Versionen.
AstroPaper legt großen Wert auf Barrierefreiheit. Die Bedienung per Tastatur funktioniert, und der Maintainer hat das Theme mit VoiceOver und TalkBack getestet. Das ist eine gute Basis, ersetzt aber keine Prüfung deiner eigenen Inhalte. Farben, Bilder ohne Alt Text oder eigene Komponenten können neue Barrieren erzeugen.
AstroPaper nutzt Pagefind. Pagefind baut den Suchindex beim Build und legt ihn als statische Dateien neben dein Blog. Im Browser lädt die Suche nur die Teile des Index, die sie gerade braucht. Du brauchst dafür keinen Server und keinen externen Suchdienst.
Ja. AstroPaper ist für i18n vorbereitet. Die Texte der Oberfläche liegen in eigenen Sprachdateien. In der Konfiguration stellst du Sprache und Zeitzone ein, zum Beispiel de und Europe/Berlin. Deine Beiträge schreibst du ohnehin selbst in Markdown, also in der Sprache deiner Wahl.
AstroPaper erzeugt beim Build für jeden Beitrag ein eigenes Vorschaubild. Dafür kombiniert das Theme Satori, Sharp und Astro Fonts. Titel und Autor landen automatisch im Bild. Willst du ein eigenes Bild, setzt du im Frontmatter das Feld ogImage. Die Funktion lässt sich in der Konfiguration auch abschalten.
AstroPaper eignet sich gut für ein technisches Firmenblog mit wenigen Autoren. Für große Redaktionen fehlt eine Oberfläche, weil Inhalte als Markdown im Repo liegen. Das lässt sich mit einem Headless CMS oder Obsidian als Editor lösen. Für Marketing Seiten mit Preistabellen ist das Theme zu schlicht.
Updates holst du über Git aus dem Original Repo. Am einfachsten richtest du das Original als zweites Remote ein und mergst neue Versionen. Je mehr du am Kern änderst, desto mehr Konflikte entstehen dabei. Lege eigene Komponenten deshalb möglichst getrennt ab und halte Änderungen an Original Dateien klein.
AstroPaper ist schlicht, schnell und auf Lesbarkeit getrimmt. Fuwari setzt auf Animationen, Seitenübergänge, Banner und frei wählbare Themenfarben. AstroPaper läuft auf Astro 7, Fuwari noch auf Astro 5. Wer ein ruhiges Blog für Fachartikel sucht, greift eher zu AstroPaper. Wer einen starken Look will, schaut sich Fuwari an.
Starlight ist besser, wenn du Dokumentation baust. Es bringt Seitennavigation, Hinweisboxen, Komponenten wie Tabs und Steps und eine Struktur für viele verschachtelte Seiten mit. AstroPaper ist für Beiträge gemacht, die nach Datum und Tags sortiert sind. Viele Teams kombinieren beides, Blog mit AstroPaper und Doku mit Starlight.