Esportare le issue di Linear in Markdown (guida 2026)

Linear è veloce e ha opinioni forti: esattamente quello che i team di sviluppo cercano. È anche il posto dove si accumula una quantità enorme di conoscenza interna — repro di bug, decisioni di design, retrospettive, segnalazioni dei clienti. Tirare fuori quel materiale in Markdown apre la porta ai flussi di lavoro con l’IA, alla generazione di documentazione e all’archiviazione.

Questa guida copre tutti i metodi praticabili per esportare i contenuti di Linear.

Perché esportare Linear in Markdown?

Triage assistito dall’IA — passate le issue recenti a Claude o ChatGPT e chiedete «quali temi tornano di continuo?»
Release note dalle issue chiuse — il «Build changelog» nativo di Linear è ottimo ma rigido; con il Markdown componete come volete
Post-mortem — raccogliete la issue dell’incidente e tutte quelle collegate, sopra e sotto, in un unico documento Markdown per la retro
Base di conoscenza per il RAG — indicizzate le issue chiuse in un vector store, così i prossimi incidenti fanno riemergere quelli passati
Rassegna di portfolio — esportate le issue di un progetto in un solo file per l’aggiornamento agli stakeholder
Backup — si dorme meglio sapendo di poter ricostruire tutto se Linear dovesse cadere

Metodo 1: estensione Chrome Minibase (la più rapida da 1 a 20 issue)

Minibase converte in un clic qualsiasi issue, progetto o documento di Linear in Markdown pulito.

Cosa cattura Minibase da Linear:

Titolo della issue, stato, priorità, assegnatario, ciclo, progetto
Corpo completo della descrizione, con titoli, blocchi di codice, elenchi e allegati incorporati
Etichette e scadenze nel frontmatter
Il filo dei commenti nell’ordine di pubblicazione, con autore e orario per ciascuno
Reazioni in linea (per esempio [:tada: × 3])
Issue collegate (padre, figlie, blocca, bloccata da) come link Markdown
Allegati (immagini, documenti linkati) come riferimenti Markdown

Cosa elimina Minibase:

Barra laterale di Linear, barra dei comandi, suggerimenti di scorciatoie da tastiera
Interfaccia del workspace e widget dell’account

Quando è lo strumento giusto: raccogliere un pugno di issue per un documento, estrarre la issue madre di un incidente insieme a tutte le figlie per il post-mortem, i lavori una tantum.

Metodo 2: l’API GraphQL di Linear

Per export massivi o integrazioni scriptate, la via canonica è l’API GraphQL di Linear.

Flusso tipico:

Create una chiave API personale da Linear → Settings → API
Inviate query GraphQL in POST a https://api.linear.app/graphql con header Authorization: <api-key>
Interrogate issue, commenti, allegati e issue collegate
Percorrete la risposta e generate il Markdown

Una query di partenza:

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: programmabile, con filtri e paginazione, perfetta per gli export ricorrenti.

Contro: il serializzatore Markdown ve lo scrivete voi, e sui progetti grandi la paginazione va gestita.

Metodo 3: la CLI di Linear (@linear/cli)

Linear distribuisce una CLI che incapsula le operazioni GraphQL più comuni. Ottima per query al volo, meno per un export Markdown completo.

Esempio:

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

L’output è testo semplice o JSON. Passatelo a un convertitore (un piccolo script Node, oppure jq più un template) per ottenere Markdown.

Dove brilla: query rapide da script, job di CI che non hanno bisogno di un export ad alta fedeltà.

Metodo 4: l’export integrato di Linear

Linear → Settings → Workspace → Export oggi produce un CSV delle issue. Utile per l’analisi in un foglio di calcolo, ma non è Markdown: il passaggio da CSV a Markdown resta da scrivere.

Il flusso di lavoro di un team di sviluppo

Chi usa Linear ricade quasi sempre in uno di tre casi.

Caso A: «voglio questa issue nei miei appunti»

Aprite la issue in Linear
Cliccate Minibase nella barra di Chrome
Il file Markdown arriva nei download → trascinatelo in Obsidian, in Notion o nel vostro sistema RAG

Caso B: «generami una release note dalle issue chiuse in questo ciclo»

Usate l’API GraphQL:

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

Poi passate il risultato a uno script Node che sputi fuori un changelog Markdown da template. Punto di partenza open source: linear-cli-tools.

Caso C: «portami un progetto intero in un archivio Markdown per uno stakeholder»

Se sono 20 issue o meno: Minibase su ciascuna, a mano (è veloce).
Se sono 100 o più: uno script sull’API GraphQL.

Cosa vogliono gli agenti IA da un export di Linear

Quando l’obiettivo è dare l’export a Claude o ChatGPT perché sintetizzi:

Tenete l’identificatore della issue (ENG-1234) — all’LLM serve spesso per citarla di ritorno
Conservate i passaggi di stato — «Backlog → In Progress → Done in 3 settimane» dice molto più di un semplice «Done»
Appiattite i commenti in ordine cronologico, non raggruppati per autore
Includete il titolo delle issue collegate, non solo l’ID — «blocca ENG-1230 (onboarding rotto)» serve; «blocca ENG-1230» da solo no

L’estrazione di Minibase fa già tutto questo: Linear è un sito supportato in prima fascia e l’output è tarato per essere digerito da un LLM.

In pratica, cosa scegliere

Al volo, da 1 a 10 issue: Minibase. Gratis con salvataggi illimitati, Plus (5,99 $/mese) per modelli IA, cronologia dei salvataggi e trascrizione video.
Changelog ricorrenti: uno script sull’API GraphQL, lanciato dalla CI.
Archiviazione dell’intero workspace: API GraphQL più uno script di serializzazione, una volta sola.
«Dove avevamo deciso X il trimestre scorso?»: Minibase sulla issue della decisione, poi in Claude con «riassumi la decisione presa nel thread» → risposta in 5 secondi.

Linear è veloce. Anche i vostri export dovrebbero esserlo.

Minibase trasforma qualsiasi pagina web in Markdown pulito con un clic, dritto in un vault locale che la vostra IA può cercare. L’estensione è gratuita con salvataggi illimitati; Minibase Plus (5,99 $/mese o 34,99 $/anno) aggiunge modelli IA, cronologia e trascrizione video. minibase.md.