---
title: SK Markdown
url: https://www.sk-reg.de/index.php/sk-markdown
markdown_url: https://www.sk-reg.de/index.php/sk-markdown.md
date: 2026-11-17T17:02:21+00:00
modified: 2026-11-18T02:05:46+00:00
author: Stephan Krohn
category:
  name: Blog
  url: https://www.sk-reg.de/index.php/index.md
image_intro: https://www.sk-reg.de/images/blog_header/sk_markdown_fuer_joomla_6.png
image_fulltext: https://www.sk-reg.de/images/blog_header/hader_beitrag_750.png
---

# SK Markdown

Die Komponente exportiert die Inhalte einer Joomla Webpräsenz direkt aus dem fertig gerenderten Seitentemplate in Form von strukturiertem Markdown an automatisierte Crawler sowie KI Agenten.

Joomla 6 · System Plugin

Liefert die Inhalte deiner Joomla Website als sauberes Markdown an KI Agenten und Crawler, direkt aus dem fertig gerenderten Seitentemplate. Normale Besucher sehen die Seite unverändert.

.md URL llms.txt Seitenfilter RAG Export Mehrsprachig

### So fragt ein Agent Markdown an

| Weg | Beispiel |
| --- | --- |
| **.md URL** | `/mein-beitrag.md` · Startseite `/index.md` · Sprache `/de/index.md` |
| **Query Parameter** | `/mein-beitrag?output=markdown` |
| **Accept Header** | `Accept: text/markdown` |
| **User Agent** (optional) | GPTBot, ClaudeBot, PerplexityBot u. a. Die Liste ist im Backend änderbar. |

Läuft deine Seite ohne URL Rewrite, funktioniert alles über `/index.php/mein-beitrag.md`, die Startseite ist dann `/index.php/index.md`.

### Ausgabe

- **Sauberes Markdown:** Überschriften, Absätze, Listen (verschachtelt), Tabellen, Codeblöcke, Zitate, Bilder und Links. Bilder ohne Alt Text bekommen den Titel ihres Links.
- **YAML Frontmatter:** Titel, URL, Markdown URL, Sprache, Beschreibung, Datum und Änderungsdatum, Autor, Kategorie, Tags und Beitragsbilder. Jedes Feld lässt sich einzeln abschalten.
- **Interne Links auf .md:** Agenten können der Seitenstruktur folgen. PDFs und Bilder bleiben unverändert.
- **Seitennavigation:** Auf Kategorieseiten bleiben die Links zur nächsten und vorherigen Seite als `.md` Links erhalten, sodass ein Agent eine ganze Übersicht durchblättern kann.
- **Benutzerfelder:** Custom Fields lassen sich als eigener Abschnitt anhängen.
- **Unterstützte Ansichten:** Beitrag, Kategorie (Blog und Liste) und Featured. Alles andere bleibt normales HTML. Fehlerseiten werden nie als Markdown ausgeliefert.

> - [![01 sk arkdown](https://www.sk-reg.de/images/skgallery-cache/b6200ca0e3a09535890658b00704e133.png)](https://www.sk-reg.de/images/gallery/sk_arkdown/01_sk_arkdown.png)
> - [![02 sk arkdown](https://www.sk-reg.de/images/skgallery-cache/1098376e5af8fefe2a37c402f9b5a82d.png)](https://www.sk-reg.de/images/gallery/sk_arkdown/02_sk_arkdown.png)
> - [![03 sk arkdown](https://www.sk-reg.de/images/skgallery-cache/ebbb856899965c94d8cdb87dadeb4145.png)](https://www.sk-reg.de/images/gallery/sk_arkdown/03_sk_arkdown.png)
> - [![04 sk arkdown](https://www.sk-reg.de/images/skgallery-cache/4325ae543846c2d5fa14e26a06113709.png)+1](https://www.sk-reg.de/images/gallery/sk_arkdown/04_sk_arkdown.png)
> - [![05 sk arkdown](https://www.sk-reg.de/images/gallery/sk_arkdown/05_sk_arkdown.png)](https://www.sk-reg.de/images/gallery/sk_arkdown/05_sk_arkdown.png)

### llms.txt

Unter `/llms.txt` entsteht automatisch ein Verzeichnis aller öffentlichen Beiträge mit ihren `.md` URLs, nach Kategorien gruppiert. Titel und Kurzbeschreibung sind einstellbar. Auf mehrsprachigen Seiten gibt es zusätzlich `/de/llms.txt`, `/en/llms.txt` usw. Beiträge mit gleichem Alias erscheinen nur einmal.

### Seitenfilter

Je eine Regel für **Artikel** und **Kategorien**: nur diese einschließen oder diese ausschließen, wahlweise samt Unterkategorien. „Nur diese“ ohne Auswahl sperrt alles. Der Filter gilt identisch für Live Ausgabe, llms.txt und Export.

### Alternate Link und Link Header

Auf Beitrags, Kategorie und Startseiten fügt das Plugin `<link rel="alternate" type="text/markdown">` in den Head ein, auf Wunsch zusätzlich einen HTTP Link Header. So finden Agenten die Markdown Fassung von selbst.

### Zusammenspiel mit SK Scraping Schutz

Sperrt der SK Scraping Schutz KI Crawler, kannst du dort die Option **KI Crawler nur für Markdown durchlassen** aktivieren. Ein erkannter KI Crawler bekommt dann auf der normalen Seiten URL direkt die Markdown Fassung statt einer 403 Seite. Seiten, die sich nicht als Markdown ausgeben lassen (etwa Login oder Komponenten), bleiben für ihn gesperrt.

### Batch Export für RAG

Schreibt alle erlaubten Beiträge als `.md` Dateien in ein Verzeichnis (Standard `images/rag-export`), ideal als Wissensbasis für eigene KI Anwendungen.

- Arbeitet in Blöcken mit Fortschrittsseite und Pause zwischen den Abrufen.
- Merkt sich den Stand, schreibt nur geänderte Dateien neu und entfernt Dateien nicht mehr erlaubter Beiträge.
- Bricht bei Offline Modus oder vorübergehenden Serverfehlern ab, ohne etwas zu löschen.

```
/index.php?output=markdown-export&secret=DEIN-TOKEN
&format=json   (für Cron)
&force=1       (alle neu exportieren)
&reset=1       (löschen und neu beginnen)
```

### Weitere Einstellungen

- **Content Selektor (XPath):** Hauptbereich der Seite selbst festlegen, sonst automatisch (main, article, #content …).
- **Zusätzlich entfernen (XPath):** Elemente wie Bewertung, Empfehlungen oder Werbung aus dem Markdown streichen.
- **Cache:** Markdown Ausgabe für Gäste für eine einstellbare Zeit zwischenspeichern.
- **Debug Modus:** `?output=markdown&debug=1` liefert einen Textreport, übersprungene Anfragen erscheinen im Log.
- **Kategorieseiten:** Anzahl der Beiträge pro Seite begrenzen.

**Hinweis zum Seiten Cache:** Nutzt du einen Cache eines Drittanbieters (z. B. JCH Optimize), rufe nach dem Aktivieren einmal `/seite.md` auf. Kommt dort HTML statt Markdown, nimm die `.md` URLs vom Cache aus.

### Installation

- ZIP unter *System → Erweiterungen → Installieren* hochladen.
- Plugin „System SK Markdown“ aktivieren.
- Einstellungen in den vier Reitern Grundeinstellungen, Filterung, Export / RAG und Erweitert vornehmen.

Autor: Stephan Krohn · Lizenz: GPL v2 oder neuer

 [Download unter Plugin:](https://sk-reg.de/index.php/component/skdownloads/?view=category&layout=file&fileid=35)
