Как экспортировать задачи Linear в Markdown (2026)

Linear быстрый и с характером — ровно то, чего хотят инженерные команды. Заодно именно в нём накапливается огромный пласт институциональной памяти: воспроизведения багов, проектные решения, ретроспективы, жалобы клиентов. Вытащить это в Markdown — значит открыть дорогу к ИИ-сценариям, генерации документации и нормальному архиву.

В этом руководстве — все рабочие способы вынести содержимое Linear наружу.

Зачем экспортировать Linear в Markdown?

  • Разбор задач с помощью ИИ — отдайте свежие задачи Claude или ChatGPT и спросите: «какие темы повторяются?»
  • Release notes из закрытых задач — встроенный «Build changelog» в Linear хорош, но негибок; Markdown позволяет собирать что и как угодно
  • Разборы инцидентов — соберите задачу об аварии вместе со всеми связанными родителями и потомками в один Markdown-документ к ретро
  • База знаний для RAG — залейте закрытые задачи в векторное хранилище, и будущие инциденты сами подтянут похожие прошлые
  • Обзор портфеля — выгрузите задачи проекта одним файлом для отчёта стейкхолдерам
  • Резервная копия — спится спокойнее, когда знаешь, что восстановишь всё, даже если Linear ляжет

Способ 1: расширение Minibase для Chrome (быстрее всего на 1–20 задачах)

Minibase превращает страницу любой задачи, проекта или документа Linear в чистый Markdown одним кликом.

Что Minibase забирает из Linear:

  • Заголовок задачи, статус, приоритет, исполнителя, цикл, проект
  • Полное описание с заголовками, блоками кода, списками и вложениями
  • Метки и сроки — во frontmatter
  • Тред комментариев в порядке публикации, с автором и временем у каждого
  • Реакции инлайном (например, [:tada: × 3])
  • Связанные задачи (родитель, потомок, блокирует, заблокирована) как ссылки Markdown
  • Вложения (картинки, прикреплённые документы) как ссылки Markdown

Что Minibase выбрасывает:

  • Боковую панель Linear, командную строку, подсказки горячих клавиш
  • Обвязку рабочего пространства и виджеты аккаунта

Когда это именно тот инструмент: нужно вытащить несколько задач под текст, собрать родительскую задачу инцидента со всеми потомками к разбору, сделать быструю разовую выгрузку.

Способ 2: GraphQL API Linear

Для массовых выгрузок и интеграций канонический путь — GraphQL API Linear.

Как это обычно выглядит:

  1. Создайте личный API-ключ: Linear → Settings → API
  2. Отправляйте GraphQL-запросы на https://api.linear.app/graphql с заголовком Authorization: <api-key>
  3. Запрашивайте задачи, комментарии, вложения и связанные задачи
  4. Обойдите ответ и соберите Markdown

Запрос для начала:

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

Плюсы: программно, есть фильтрация и постраничная выборка, идеально для регулярных выгрузок.

Минусы: сериализатор Markdown пишете вы сами; на больших проектах придётся возиться с пагинацией.

Способ 3: Linear CLI (@linear/cli)

У Linear есть CLI, который оборачивает частые операции GraphQL. Хорош для разовых запросов, хуже — для полноценного экспорта в Markdown.

Пример:

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

На выходе обычный текст или JSON. Пропустите через конвертер (небольшой скрипт на Node или jq с шаблоном), чтобы получить Markdown.

Где он выигрывает: быстрые скриптовые запросы, задачи CI, где полноценная выгрузка не нужна.

Способ 4: штатный экспорт Linear

Linear → Settings → Workspace → Export пока отдаёт CSV со списком задач. Годится для анализа в таблице, но не для Markdown: шаг «CSV → Markdown» всё равно придётся написать самому.

Как это устроено у инженерных команд

Почти все пользователи Linear попадают в один из трёх сценариев.

Сценарий A: «хочу эту задачу в заметках»

  1. Откройте задачу в Linear
  2. Нажмите Minibase на панели Chrome
  3. Файл Markdown падает в загрузки → перетащите в Obsidian, Notion или свою RAG-систему

Сценарий B: «собрать release note из закрытых задач цикла»

Через GraphQL API:

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

Отдайте результат скрипту на Node, который соберёт changelog по шаблону. Открытая заготовка: linear-cli-tools.

Сценарий C: «выгрузить весь проект в Markdown-архив для стейкхолдера»

  • Задач 20 или меньше: пройдите Minibase по каждой вручную, это быстро.
  • Задач 100 и больше: пишите скрипт на GraphQL API.

Что ИИ-агенты хотят видеть в выгрузке из Linear

Когда цель — отдать экспорт Claude или ChatGPT на осмысление:

  • Оставляйте идентификатор задачи (ENG-1234) — модели он часто нужен, чтобы сослаться обратно
  • Сохраняйте смену статусов — «Backlog → In Progress → Done за 3 недели» говорит куда больше, чем просто «Done»
  • Разворачивайте комментарии в хронологию, а не группируйте по авторам
  • Подставляйте названия связанных задач, а не только их ID — «блокирует ENG-1230 (сломанный онбординг)» полезно, «блокирует ENG-1230» само по себе — нет

Извлечение в Minibase всё это уже умеет: Linear — сайт первой линии поддержки, а вывод настроен под чтение моделями.

Что выбрать на практике

  • Разово, 1–10 задач: Minibase. Бесплатно — неограниченные сохранения, Plus ($5,99/мес.) — ИИ-шаблоны, история сохранений и транскрипция видео.
  • Регулярная сборка changelog: скрипт на GraphQL API, запускаемый из CI.
  • Архив всего рабочего пространства: GraphQL API плюс скрипт сериализации, один прогон.
  • «Где мы решили X в прошлом квартале»: Minibase на задаче с решением, затем в Claude с просьбой пересказать вывод треда — ответ за пять секунд.

Linear быстрый. Ваши выгрузки должны быть такими же.


Minibase превращает любую веб-страницу в чистый Markdown одним кликом, прямо в локальное хранилище, по которому ваш ИИ может искать. Расширение бесплатно с неограниченным числом сохранений; Minibase Plus ($5,99/мес. или $34,99/год) добавляет ИИ-шаблоны, историю и транскрипцию видео. minibase.md.

Continue reading

Готовы сохранять умнее?

Конвертируйте любую веб-страницу в Markdown одним кликом.

Добавить в Chrome