Cómo exportar issues de Linear a Markdown (guía 2026)

Linear es rápido y tiene opiniones fuertes, que es justo lo que quiere un equipo de ingeniería. También es donde se acumula una cantidad enorme de conocimiento institucional: reproducciones de bugs, decisiones de diseño, retrospectivas, reportes de clientes. Sacar todo eso en Markdown te abre los flujos con IA, la generación de documentación y el archivado.

Esta guía repasa todos los métodos que funcionan para exportar contenido de Linear.

Por qué exportar Linear a Markdown

Triaje asistido por IA — pásale los issues recientes a Claude o ChatGPT y pregunta «¿qué temas se repiten?»
Notas de versión a partir de los issues cerrados — el «Build changelog» nativo de Linear está bien, pero es rígido; con Markdown combinas lo que quieras
Post-mortems — junta el issue del incidente y todos sus padres e hijos enlazados en un único documento Markdown para la retro
Base de conocimiento para RAG — mete los issues cerrados en un vector store y los incidentes futuros harán aflorar los pasados que se parecen
Revisión de cartera — exporta los issues de un proyecto en un solo archivo para actualizar a un stakeholder
Copia de seguridad — se duerme mejor sabiendo que puedes reconstruirlo todo si Linear se cae

Método 1: extensión de Chrome de Minibase (lo más rápido para 1–20 issues)

Minibase convierte cualquier issue, proyecto o documento de Linear en Markdown limpio con un solo clic.

Lo que Minibase captura de Linear:

Título, estado, prioridad, responsable, ciclo y proyecto del issue
Todo el cuerpo de la descripción, con títulos, bloques de código, listas y adjuntos embebidos
Etiquetas y fechas límite como frontmatter
El hilo de comentarios en orden de publicación, con autor y fecha en cada uno
Reacciones en línea (por ejemplo, [:tada: × 3])
Issues relacionados (padre, hijo, bloquea, bloqueado por) como enlaces Markdown
Adjuntos (imágenes, documentos enlazados) como referencias Markdown

Lo que Minibase elimina:

La barra lateral de Linear, la barra de comandos y los avisos de atajos de teclado
La interfaz del workspace y los widgets de cuenta

Cuándo es la herramienta adecuada: recoger un puñado de issues para redactar algo, extraer el issue de un incidente con todos sus hijos para el post-mortem, o cualquier cosa puntual.

Método 2: la API GraphQL de Linear

Para exportaciones masivas o integraciones automatizadas, la API GraphQL de Linear es la vía canónica.

Flujo habitual:

Crea una API key personal desde Linear → Settings → API
Envía tus consultas GraphQL por POST a https://api.linear.app/graphql con la cabecera Authorization: <api-key>
Consulta issues, comentarios, adjuntos e issues enlazados
Recorre la respuesta y genera el Markdown

Una consulta para empezar:

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

A favor: es programático, admite filtros y paginación, y va perfecto para exportaciones recurrentes.

En contra: el serializador a Markdown lo escribes tú, y la paginación se complica en proyectos grandes.

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

Linear publica una CLI que envuelve las operaciones GraphQL más comunes. Va bien para consultas puntuales, menos para exportaciones completas a Markdown.

Ejemplo:

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

La salida es texto plano o JSON. Pásala por un conversor (un script pequeño de Node, o jq con una plantilla) para obtener Markdown.

Dónde brilla: consultas rápidas desde un script y jobs de CI que no necesitan una exportación fiel al detalle.

Método 4: la exportación integrada de Linear

Linear → Settings → Workspace → Export exporta hoy por hoy un CSV de issues. Sirve para analizar en una hoja de cálculo, pero no es Markdown: seguirías teniendo que programar el paso de CSV a Markdown.

El flujo de trabajo de un equipo de ingeniería

Casi todo el mundo que usa Linear cae en uno de estos tres cajones:

Cajón A: «quiero este issue en mis notas»

Abre el issue en Linear
Haz clic en Minibase en la barra de Chrome
El archivo Markdown aterriza en tus descargas → arrástralo a Obsidian, Notion o tu sistema RAG

Cajón B: «genera las notas de versión con los issues cerrados de este ciclo»

Usa la API GraphQL:

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

Pásalo a un script de Node que escupa un changelog Markdown con plantilla. Punto de partida en código abierto: linear-cli-tools.

Cajón C: «pásame un proyecto entero a un archivo Markdown para un stakeholder»

Si son 20 issues o menos: Minibase uno a uno (va rápido).
Si son más de 100: script contra la API GraphQL.

Qué necesitan los agentes de IA de una exportación de Linear

Cuando el objetivo es darle la exportación a Claude o ChatGPT para que sintetice:

Conserva el identificador del issue (ENG-1234) — el LLM suele necesitar referirse a él
Guarda las transiciones de estado — «Backlog → In Progress → Done en 3 semanas» dice mucho más que un simple «Done»
Aplana los hilos de comentarios en orden cronológico, no agrupados por autor
Incluye el título de los issues enlazados, no solo su ID — «bloquea ENG-1230 (onboarding roto)» es útil; «bloquea ENG-1230» a secas, no

La extracción de Minibase ya hace todo esto: Linear es un sitio soportado de primer nivel y la salida está afinada para que la consuma un LLM.

La decisión práctica

Puntual, entre 1 y 10 issues: Minibase. Gratis → guardados ilimitados; Plus (5,99 $/mes) → plantillas de IA, historial y transcripción de vídeo.
Generar el changelog cada ciclo: un script contra la API GraphQL, lanzado desde CI.
Archivar el workspace entero: API GraphQL más un script de serialización, en una única pasada.
«¿Dónde decidimos X el trimestre pasado?»: Minibase sobre el issue de la decisión, se lo sueltas a Claude con «resume la decisión de este hilo» → respuesta en cinco segundos.

Linear es rápido. Tus exportaciones también deberían serlo.

Minibase convierte cualquier página web en Markdown limpio con un clic, directo a un vault local que tu IA puede buscar. La extensión es gratis con guardados ilimitados; Minibase Plus (5,99 $/mes o 34,99 $/año) añade plantillas de IA, historial y transcripción de vídeo. minibase.md.