Dieser Blog ist ein Ordner voller Markdown-Dateien

Hinter diesem Blog steht kein CMS und auch keine Datenbank. Jeder Beitrag ist eine Markdown-Datei, die im selben Repository wie der Code von LiteTMS committet wird. Das Veröffentlichen eines Beitrags funktioniert daher genau wie das Ausrollen einer Funktion: ein Commit und ein Deploy.

Wir wollten das anders handhaben als die meisten Unternehmensblogs. Dieser Beitrag zeigt Ihnen die gesamte Funktionsweise, einschließlich des Quelltexts genau der Seite, die Sie gerade lesen.

Das Setup, das alle anderen nutzen

Ein typischer Unternehmensblog läuft auf einem vollwertigen Content-Management-System: eine Datenbank, ein Admin-Bereich, Benutzerkonten, Plugins und ein Theme, das sich bei jeder Anpassung sperrt. Diese ganze Maschinerie existiert nur, damit eine Redaktion Inhalte veröffentlichen kann, ohne mit Code in Berührung zu kommen.

Wir haben keine Redaktion, und wir verbringen ohnehin den ganzen Tag im Code-Repository. Also haben wir uns diese Maschinerie gespart. Jedes zusätzliche System muss gepatched, gesichert und gewartet werden. Ein Ordner voller Textdateien nicht.

Wie eine Beitragsdatei aufgebaut ist

Hier ist ein gekürzter Auszug des Headers dieses Beitrags, gefolgt von der Struktur des Textkörpers:

---
title: This blog is a folder of markdown files
slug: why-this-blog-has-no-cms
locale: en
description: There is no CMS behind the LiteTMS blog. Every post is...
date: 2026-07-15
category: technology
tags: markdown, blog, aieo, engineering
draft: false
---

The first paragraph answers the title on its own, because that is
the part search snippets and AI assistants quote.

## A section heading

Plain markdown body. Nothing exotic.

## FAQ

### Does this sample show the FAQ convention?

Yes. Each ### line is a literal question, answered right below it.

Der Block oben ist eine einfache Liste aus Schlüssel-Wert-Paaren. Darunter folgt gewöhnliches Markdown, gerendert von einer Standard-Markdown-Bibliothek. Eine Datei pro Sprache: Dieser Beitrag existiert als .en.md-Datei und als .pl.md-Datei unter demselben Namen, wobei die polnische Version direkt nativ verfasst und nicht maschinell übersetzt wurde.

Der Abschnitt ## FAQ am Ende des Beispiels ist eine feste Konvention, keine Dekoration. Jede Frage entspricht genau dem, was jemand in ein Suchfeld eingeben würde. Der Build-Prozess wandelt diese Paare in strukturierte Daten um, die Suchmaschinen als Rich Results anzeigen können. Ein reales Beispiel finden Sie ganz unten auf dieser Seite.

Ein Validator statt eines Editors

Bevor etwas live geht, liest ein Build-Skript jede Beitragsdatei ein und gleicht sie mit dem Schema ab. Die Description muss zwischen 80 und 170 Zeichen lang sein. Die Kategorie muss einem von fünf erlaubten Werten entsprechen. Das Datum muss ein echtes Kalenderdatum sein, und der Slug muss mit dem Dateinamen übereinstimmen.

Anschließend schreibt das Skript eine einzige Indexdatei mit den Metadaten aller Beiträge, und die Website liest ausschließlich diese Datei ein. Eine Übersichtsseite verursacht bei fünfhundert Beiträgen denselben Aufwand wie bei fünf.

Dasselbe Skript läuft bei jedem Push in der CI. Ist ein Beitrag ungültig oder wurde vergessen, den Index neu zu generieren, schlägt der Build fehl und es wird nichts bereitgestellt. Fehlerhafte Inhalte können die Produktionsumgebung nicht erreichen, da dorthin nur gelangt, was die Validierung bestanden hat.

Warum Markdown? Ganz ehrlich

Markdown hat sich aus ganz unspektakulären Gründen durchgesetzt. Eine Markdown-Datei lässt sich in jedem beliebigen Texteditor lesen, mit oder ohne Spezialwerkzeuge. Änderungen lassen sich Zeile für Zeile vergleichen, sodass ein Beitrag wie Programmcode gereviewt werden kann: Man sieht exakt, welcher Satz geändert wurde. Außerdem ist es das denkbar schlankeste Format für die Verarbeitung durch KI-Assistenten, was von Monat zu Monat wichtiger wird.

Aus genau diesem Grund wird jeder Beitrag hier auf drei Arten bereitgestellt. Die Seite, die Sie gerade lesen, ist die HTML-Version. Wenn Sie in Ihrem Browser .md an die Adresse anhängen, erhalten Sie die unveränderte Quelldatei, Byte für Byte wie committet, als reines Markdown. Zudem verfügt jede Sprache über einen eigenen RSS-Feed für Leser und Aggregatoren.

Unter /blog/index.md gibt es außerdem einen maschinenlesbaren Katalog aller veröffentlichten Beiträge, auf den die llms.txt der Website KI-Crawler direkt verweist. Nichts davon führt jemals zu Duplicate Content, da die Rohdateien einen noindex-Header sowie einen Canonical-Link zurück zur HTML-Seite enthalten.

Was Sie als Leser davon haben

Nichts davon ist ein Produktfeature. Es ist eine Grundsatzentscheidung darüber, wie wir publizieren, und sie passt zu dem Versprechen aus dem ersten Beitrag: keine erfundenen Zahlen und Texte, die sich direkt an der Quelle überprüfen lassen. Das TMS selbst basiert auf derselben Vorliebe für einfache, nachvollziehbare Mechanismen. Wenn Sie sich selbst ein Bild machen möchten: Die Registrierung ist kostenlos.