Linear-Issues als Markdown exportieren (Anleitung 2026)

#linear#markdown#engineering#project-management#workflow

Linear ist schnell und hat eine klare Meinung — genau das, was Engineering-Teams wollen. Es ist zugleich der Ort, an dem sich enorme Mengen an institutionellem Wissen ansammeln: Bug-Repros, Design-Entscheidungen, Retrospektiven, Kundenmeldungen. Diese Inhalte als Markdown herauszuholen, öffnet die Tür zu KI-Workflows, Doku-Generierung und Archivierung.

Diese Anleitung deckt jede praktikable Methode ab, Linear-Inhalte zu exportieren.

Warum Linear als Markdown exportieren?

  • KI-gestützte Triage — gib Claude oder ChatGPT die jüngsten Issues und frag „welche Themen kommen immer wieder?”
  • Release Notes aus abgeschlossenen Issues — Linears eigenes „Build changelog” ist gut, aber unflexibel; mit Markdown kombinierst du frei
  • Post-mortems — zieh das Incident-Issue samt aller verknüpften Eltern- und Kind-Issues in ein einziges Markdown-Dokument für die Retro
  • RAG-Wissensdatenbank — abgeschlossene Issues in einen Vektorspeicher laden, damit künftige Vorfälle die passenden alten hervorholen
  • Portfolio-Review — die Issues eines Projekts als einzelne Datei für ein Stakeholder-Update exportieren
  • Backup — ruhiger schlafen, weil du alles rekonstruieren kannst, falls Linear ausfällt

Methode 1: Minibase Chrome-Erweiterung (am schnellsten für 1–20 Issues)

Minibase wandelt jedes Linear-Issue, -Projekt oder -Dokument mit einem Klick in sauberes Markdown.

Was Minibase aus Linear erfasst:

  • Issue-Titel, Status, Priorität, zuständige Person, Cycle, Projekt
  • Vollständiger Beschreibungstext mit Überschriften, Codeblöcken, Listen und eingebetteten Anhängen
  • Labels und Fälligkeitsdaten als Frontmatter
  • Kommentarverlauf in der Reihenfolge der Veröffentlichung, mit Autor und Zeitstempel pro Kommentar
  • Reaktionen inline (z. B. [:tada: × 3])
  • Verknüpfte Issues (Eltern/Kind/blockiert/blockiert von) als Markdown-Links
  • Anhänge (Bilder, verlinkte Dokumente) als Markdown-Verweise

Was Minibase entfernt:

  • Linear-Seitenleiste, Command Bar, Hinweise auf Tastenkürzel
  • Workspace-Oberfläche und Konto-Widgets

Wann es das richtige Werkzeug ist: eine Handvoll Issues für einen Text zusammenziehen, das Eltern-Issue eines Vorfalls samt aller Kind-Issues für ein Post-mortem herausholen, schnelle Einzelfälle.

Methode 2: Linear GraphQL-API

Für Massenexporte oder die Anbindung per Skript ist Linears GraphQL-API der kanonische Weg.

Typischer Ablauf:

  1. Einen persönlichen API-Key unter Linear → Settings → API anlegen
  2. GraphQL-Abfragen per POST an https://api.linear.app/graphql schicken, mit dem Header Authorization: <api-key>
  3. Issues, Kommentare, Anhänge und verknüpfte Issues abfragen
  4. Die Antwort durchlaufen und Markdown ausgeben

Eine Abfrage für den Anfang:

query {
  issues(first: 100, filter: { project: { id: { eq: "PROJECT_ID" } } }) {
    nodes {
      identifier
      title
      description
      state { name }
      assignee { name }
      priority
      labels { nodes { name } }
      comments { nodes { body user { name } createdAt } }
    }
  }
}

Pro: programmatisch, unterstützt Filter und Paginierung, ideal für wiederkehrende Exporte.

Contra: den Markdown-Serialisierer schreibst du selbst; Paginierung bei großen Projekten.

Methode 3: Linear CLI (@linear/cli)

Linear liefert ein CLI mit, das gängige GraphQL-Operationen kapselt. Gut für spontane Abfragen, weniger für vollwertige Markdown-Exporte.

Beispiel:

npx @linear/cli issues list --project "Engineering Migration"

Die Ausgabe ist reiner Text oder JSON. Leite sie durch einen Konverter (etwa ein kleines Node-Skript oder jq plus Template), um Markdown zu erzeugen.

Wo es glänzt: schnelle Abfragen per Skript, CI-Jobs, die keinen vollständigen Export brauchen.

Methode 4: Linears eingebauter Export

Linear → Settings → Workspace → Export exportiert derzeit eine CSV der Issues. Nützlich für die Auswertung in der Tabellenkalkulation, aber kein Markdown. Den Schritt von CSV zu Markdown müsstest du weiterhin selbst skripten.

Der Workflow fürs Engineering-Team

Die meisten Linear-Nutzer fallen in einen von drei Fällen:

Fall A: „Ich will dieses Issue in meinen Notizen”

  1. Issue in Linear öffnen
  2. Minibase in der Chrome-Symbolleiste anklicken
  3. Die Markdown-Datei landet in den Downloads → per Drag-and-drop nach Obsidian, Notion oder in dein RAG-System

Fall B: „Erzeuge Release Notes aus den abgeschlossenen Issues dieses Cycles”

Nimm die GraphQL-API:

query {
  issues(filter: { cycle: { id: { eq: "CYCLE_ID" } }, state: { type: { eq: "completed" } } }) {
    nodes { identifier title description labels { nodes { name } } }
  }
}

Leite das an ein Node-Skript weiter, das ein Changelog nach Vorlage in Markdown ausgibt. Open-Source-Einstieg: linear-cli-tools.

Fall C: „Ein komplettes Projekt als Markdown-Archiv für einen Stakeholder”

  • Bei 20 Issues oder weniger: jedes einzeln mit Minibase sichern (geht schnell).
  • Bei 100 und mehr: die GraphQL-API skripten.

Was KI-Agenten von Linear-Exporten brauchen

Wenn der Export am Ende bei Claude oder ChatGPT zur Synthese landen soll:

  • Den Issue-Identifier behalten (ENG-1234) — das LLM muss ihn oft zurückgeben können
  • Statuswechsel bewahren — „Backlog → In Progress → Done über 3 Wochen” sagt mehr als bloß „Done”
  • Kommentarverläufe chronologisch flach ausgeben — nicht nach Autor gruppiert
  • Die Titel verknüpfter Issues mitgeben, nicht nur deren IDs — „blockiert ENG-1230 (kaputter Onboarding-Flow)” hilft; „blockiert ENG-1230” allein nicht

Minibases Extraktion macht all das bereits — Linear ist eine Tier-1-Website und die Ausgabe ist auf LLM-Verwertung abgestimmt.

Die praktische Entscheidung

  • Spontan, 1–10 Issues: Minibase. Kostenlos → unbegrenzte Speicherungen, Plus (5,99 $/Monat) → KI-Vorlagen, gespeicherter Verlauf und Videotranskription.
  • Regelmäßige Changelogs: GraphQL-API-Skript, aus der CI heraus gestartet.
  • Vollständige Workspace-Archivierung: GraphQL-API plus ein Serialisierungsskript, einmalig ausgeführt.
  • „Wo haben wir letztes Quartal X entschieden?”: Minibase auf das Entscheidungs-Issue, ab in Claude mit „fass die Entscheidung des Threads zusammen” → Antwort in 5 Sekunden.

Linear ist schnell. Deine Exporte sollten es auch sein.

Minibase verwandelt jede Webseite mit einem Klick in sauberes Markdown, direkt in einen lokalen Vault, den deine KI durchsuchen kann. Die Erweiterung ist kostenlos mit unbegrenzten Speicherungen; Minibase Plus (5,99 $/Monat oder 34,99 $/Jahr) ergänzt KI-Vorlagen, Verlauf und Videotranskription. minibase.md.

Continue reading