Como exportar issues do Linear para Markdown (guia 2026)

O Linear é rápido e opinativo — exatamente o que times de engenharia querem. Também é onde se acumula uma quantidade enorme de conhecimento institucional: repros de bug, decisões de design, retrospectivas, relatos de cliente. Tirar esse conteúdo de lá em Markdown destrava fluxos com IA, geração de documentação e arquivamento.

Este guia cobre todos os métodos que funcionam na prática para exportar conteúdo do Linear.

Por que exportar o Linear para Markdown?

Triagem com IA — entregue as issues recentes ao Claude ou ao ChatGPT e pergunte «que temas estão se repetindo?»
Release notes a partir das issues fechadas — o «Build changelog» nativo do Linear é ótimo, mas engessado; com Markdown você mistura o que quiser
Post-mortems — puxe a issue do incidente mais todos os pais e filhos vinculados para um único documento Markdown antes da retro
Base de conhecimento para RAG — ingira as issues fechadas num vector store para que incidentes futuros tragam à tona os casos parecidos do passado
Revisão de portfólio — exporte as issues de um projeto num arquivo só para atualizar um stakeholder
Backup — dormir melhor sabendo que dá para reconstruir tudo se o Linear cair

Método 1: extensão Minibase para Chrome (mais rápido para 1–20 issues)

O Minibase converte qualquer página de issue, projeto ou documento do Linear em Markdown limpo, com um clique.

O que o Minibase captura do Linear:

Título, status, prioridade, responsável, ciclo e projeto da issue
Corpo completo da descrição, com títulos, blocos de código, listas e anexos embutidos
Labels e prazos como frontmatter
Thread de comentários na ordem em que foram postados, com autor e horário em cada um
Reações inline (ex.: [:tada: × 3])
Issues vinculadas (pai/filho/bloqueia/bloqueada por) como links Markdown
Anexos (imagens, documentos vinculados) como referências Markdown

O que o Minibase descarta:

Barra lateral, command bar e dicas de atalho de teclado do Linear
Interface do workspace e widgets de conta

Quando é a ferramenta certa: puxar um punhado de issues para um texto, extrair a issue-pai de um incidente com todas as filhas para um post-mortem, resolver casos pontuais.

Método 2: API GraphQL do Linear

Para exportações em massa ou integração via script, a API GraphQL do Linear é o caminho canônico.

Fluxo típico:

Crie uma chave de API pessoal em Linear → Settings → API
Faça POST das queries GraphQL para https://api.linear.app/graphql com o header Authorization: <api-key>
Consulte issues, comentários, anexos e issues vinculadas
Percorra a resposta e gere o Markdown

Uma query para começar:

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

Prós: programático, aceita filtros e paginação, perfeito para exportações recorrentes.

Contras: o serializador de Markdown é por sua conta; e há paginação a resolver em projetos grandes.

Método 3: CLI do Linear (@linear/cli)

O Linear tem uma CLI que embrulha as operações GraphQL mais comuns. Boa para consultas pontuais, menos para exportações completas em Markdown.

Exemplo:

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

A saída é texto puro ou JSON. Passe por um conversor (um scriptzinho em Node ou jq + template) para gerar Markdown.

Onde brilha: consultas rápidas via script, jobs de CI que não precisam de exportação fiel ao original.

Método 4: exportação nativa do Linear

Linear → Settings → Workspace → Export hoje exporta um CSV de issues. Serve para análise em planilha; não é Markdown. Você ainda teria que scriptar a etapa de CSV para Markdown.

O fluxo para times de engenharia

A maioria dos usuários do Linear cai em um de três grupos:

Grupo A: «quero essa issue nas minhas notas»

Abra a issue no Linear
Clique no Minibase na barra de ferramentas do Chrome
O arquivo Markdown cai nos seus downloads → arraste para o Obsidian, o Notion ou o seu sistema de RAG

Grupo B: «gerar uma release note com as issues fechadas neste ciclo»

Use a API GraphQL:

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

Jogue num script Node que gere um changelog Markdown a partir de um template. Ponto de partida open source: linear-cli-tools.

Grupo C: «levar um projeto inteiro para um arquivo Markdown e mandar para um stakeholder»

Se forem 20 issues ou menos: passe o Minibase uma a uma (é rápido).
Se forem mais de 100: scripte a API GraphQL.

O que os agentes de IA querem de uma exportação do Linear

Quando o objetivo é entregar a exportação ao Claude ou ao ChatGPT para sintetizar:

Mantenha o identificador da issue (ENG-1234) — o LLM costuma precisar dele para referenciar de volta
Preserve as transições de status — «Backlog → In Progress → Done em 3 semanas» informa muito mais do que só «Done»
Achate as threads de comentário em ordem cronológica — não agrupadas por autor
Inclua o título das issues vinculadas, não só o ID — «bloqueia ENG-1230 (fluxo de onboarding quebrado)» é útil; «bloqueia ENG-1230» sozinho não é

A extração do Minibase já faz tudo isso — o Linear é um site suportado em tier 1 e a saída é calibrada para consumo por LLM.

A escolha na prática

Pontual, de 1 a 10 issues: Minibase. Gratuito → salvamentos ilimitados; Plus (US$ 5,99/mês) → modelos de IA, histórico salvo e transcrição de vídeo.
Geração recorrente de changelog: script na API GraphQL, rodando na CI.
Arquivamento do workspace inteiro: API GraphQL + um script de serialização, execução única.
«Onde a gente decidiu X no trimestre passado?»: Minibase na issue da decisão, joga no Claude com «resuma a decisão desta thread» → resposta em 5 segundos.

O Linear é rápido. Suas exportações também deveriam ser.

O Minibase transforma qualquer página web em Markdown limpo com um clique, direto num vault local que sua IA pode pesquisar. A extensão é gratuita com salvamentos ilimitados; o Minibase Plus (US$ 5,99/mês ou US$ 34,99/ano) adiciona modelos de IA, histórico e transcrição de vídeo. minibase.md.