Exporter des issues Linear en Markdown (guide 2026)

Linear est rapide et assume ses partis pris — exactement ce que veulent les équipes d’ingénierie. C’est aussi là que s’accumule une quantité énorme de savoir maison : reproductions de bugs, décisions de conception, rétrospectives, remontées clients. Sortir ce contenu en Markdown ouvre la porte aux workflows IA, à la génération de documentation et à l’archivage.

Ce guide couvre toutes les méthodes qui marchent vraiment pour exporter du contenu Linear.

Pourquoi exporter Linear en Markdown ?

Triage assisté par l’IA — donnez les issues récentes à Claude ou ChatGPT et demandez « quels thèmes reviennent ? »
Notes de version à partir des issues fermées — le « Build changelog » natif de Linear est bon mais rigide ; le Markdown vous laisse composer
Post-mortems — regrouper l’issue d’incident et tous ses parents/enfants liés dans un seul document Markdown pour la rétro
Base de connaissances RAG — ingérer les issues fermées dans un magasin vectoriel pour que les incidents futurs fassent remonter les cas passés
Revue de portefeuille — exporter les issues d’un projet en un seul fichier pour un point avec les parties prenantes
Sauvegarde — dormir tranquille en sachant que tout est reconstructible si Linear tombe

Méthode 1 : l’extension Chrome Minibase (la plus rapide de 1 à 20 issues)

Minibase convertit n’importe quelle page d’issue, de projet ou de document Linear en Markdown propre, en un clic.

Ce que Minibase capture dans Linear :

Titre de l’issue, statut, priorité, assigné, cycle, projet
Description complète avec titres, blocs de code, listes et pièces jointes intégrées
Labels et dates d’échéance en frontmatter
Fil de commentaires dans l’ordre de publication, avec auteur et horodatage par commentaire
Réactions en inline (par exemple [:tada: × 3])
Issues liées (parent/enfant/bloque/bloquée par) sous forme de liens Markdown
Pièces jointes (images, documents liés) sous forme de références Markdown

Ce que Minibase supprime :

La barre latérale Linear, la palette de commandes, les rappels de raccourcis clavier
L’habillage de l’espace de travail et les widgets de compte

Quand c’est le bon outil : récupérer une poignée d’issues pour un compte rendu, extraire l’issue parente d’un incident et tous ses enfants pour un post-mortem, les coups ponctuels.

Méthode 2 : l’API GraphQL de Linear

Pour des exports en masse ou une intégration scriptée, l’API GraphQL de Linear est la voie canonique.

Déroulé type :

Créer une clé d’API personnelle depuis Linear → Settings → API
Envoyer des requêtes GraphQL en POST sur https://api.linear.app/graphql avec l’en-tête Authorization: <api-key>
Interroger les issues, les commentaires, les pièces jointes et les issues liées
Parcourir la réponse et générer le Markdown

Une requête pour démarrer :

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 } }
    }
  }
}

Avantages : programmatique, gère le filtrage et la pagination, parfait pour des exports récurrents.

Inconvénients : c’est vous qui écrivez le sérialiseur Markdown, et la pagination pique sur les gros projets.

Méthode 3 : la CLI Linear (@linear/cli)

Linear fournit une CLI qui enveloppe les opérations GraphQL courantes. Pratique pour des requêtes ponctuelles, moins pour un export Markdown complet.

Exemple :

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

La sortie est du texte brut ou du JSON. Passez-la dans un convertisseur (un petit script Node, ou jq + un template) pour produire du Markdown.

Là où elle brille : les requêtes scriptées rapides, les jobs de CI qui n’ont pas besoin d’un export fidèle à 100 %.

Méthode 4 : l’export intégré de Linear

Linear → Settings → Workspace → Export exporte aujourd’hui un CSV des issues. Utile pour de l’analyse en tableur, pas pour du Markdown. Il vous faudrait de toute façon scripter l’étape CSV → Markdown.

Le déroulé d’une équipe d’ingénierie

La plupart des usages de Linear tombent dans l’un de ces trois cas.

Cas A : « je veux cette issue dans mes notes »

Ouvrir l’issue dans Linear
Cliquer sur Minibase dans la barre d’outils Chrome
Le fichier Markdown atterrit dans vos téléchargements → glissez-le dans Obsidian, Notion ou votre système RAG

Cas B : « générer une note de version à partir des issues fermées de ce cycle »

Passez par l’API GraphQL :

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

Envoyez le résultat dans un script Node qui produit un changelog Markdown gabarité. Point de départ open source : linear-cli-tools.

Cas C : « sortir tout un projet en archive Markdown pour une partie prenante »

20 issues ou moins : passez Minibase sur chacune à la main (c’est rapide).
100 et plus : scriptez l’API GraphQL.

Ce que les agents IA attendent d’un export Linear

Quand le but est de donner l’export à Claude ou ChatGPT pour synthèse :

Gardez l’identifiant de l’issue (ENG-1234) — le LLM a souvent besoin d’y renvoyer
Conservez les transitions de statut — « Backlog → In Progress → Done en 3 semaines » en dit bien plus qu’un simple « Done »
Aplatissez les fils de commentaires dans l’ordre chronologique — pas regroupés par auteur
Incluez le titre des issues liées, pas seulement leur identifiant — « bloque ENG-1230 (parcours d’onboarding cassé) » est utile ; « bloque ENG-1230 » tout seul, non

L’extraction de Minibase fait déjà tout ça — Linear est un site pris en charge en priorité, et la sortie est réglée pour être lue par un LLM.

Ce qu’il faut retenir

Ponctuel, 1 à 10 issues : Minibase. Gratuit → sauvegardes illimitées, Plus (5,99 $/mois) → modèles IA, historique et transcription vidéo.
Changelog récurrent : un script sur l’API GraphQL, lancé depuis la CI.
Archivage complet de l’espace de travail : API GraphQL + un script de sérialisation, en une seule passe.
« Où est-ce qu’on a décidé X le trimestre dernier ? » : Minibase sur l’issue de décision, puis dans Claude avec « résume la décision prise dans ce fil » → réponse en 5 secondes.

Linear est rapide. Vos exports devraient l’être aussi.

Minibase convertit n’importe quelle page web — issue Linear comprise — en Markdown propre en un clic, directement dans un vault local que votre IA peut fouiller. L’extension est gratuite avec un nombre illimité de sauvegardes ; Minibase Plus (5,99 $/mois ou 34,99 $/an) ajoute les modèles IA, l’historique et la transcription vidéo. minibase.md.