Cách xuất issue Linear sang Markdown (hướng dẫn 2026)

Linear nhanh và có chính kiến — đúng thứ các đội kỹ thuật cần. Nó cũng là nơi bạn tích luỹ một lượng khổng lồ tri thức nội bộ: cách tái hiện bug, quyết định thiết kế, biên bản retro, báo cáo từ khách hàng. Lấy được đống nội dung đó ra dưới dạng Markdown sẽ mở khoá các luồng làm việc với AI, việc sinh tài liệu và cả chuyện lưu trữ.

Bài này đi qua mọi cách thực tế để xuất nội dung Linear.

Vì sao nên xuất Linear sang Markdown?

• Phân loại có AI hỗ trợ — đưa các issue gần đây cho Claude hoặc ChatGPT rồi hỏi «chủ đề nào đang lặp đi lặp lại?»
• Ghi chú phát hành từ issue đã đóng — tính năng «Build changelog» của Linear rất tốt nhưng cứng nhắc; Markdown cho bạn tự do lắp ghép
• Mổ xẻ sự cố — kéo issue của sự cố cùng toàn bộ issue cha/con liên quan vào một tài liệu Markdown duy nhất để họp retro
• Cơ sở tri thức cho RAG — nạp issue đã đóng vào một vector store để sự cố tương lai tự lôi được các ca cũ liên quan
• Điểm lại danh mục dự án — xuất toàn bộ issue của một project thành một tệp để cập nhật cho các bên liên quan
• Sao lưu — ngủ ngon hơn khi biết mình dựng lại được mọi thứ nếu Linear sập

Cách 1: Tiện ích Chrome Minibase (nhanh nhất cho 1–20 issue)

Minibase chuyển bất kỳ trang issue, project hay document nào của Linear thành Markdown sạch chỉ với một cú nhấp.

Minibase lấy được gì từ Linear:

• Tiêu đề, trạng thái, mức ưu tiên, người phụ trách, cycle, project của issue
• Toàn bộ phần mô tả kèm tiêu đề, khối mã, danh sách và tệp nhúng
• Nhãn và hạn chót đưa vào frontmatter
• Luồng bình luận theo thứ tự đăng, kèm tác giả và thời gian từng bình luận
• Biểu cảm nội dòng (ví dụ [:tada: × 3])
• Các issue liên kết (cha/con/chặn/bị chặn) dưới dạng link Markdown
• Tệp đính kèm (hình ảnh, tài liệu liên kết) dưới dạng tham chiếu Markdown

Minibase loại bỏ những gì:

• Thanh bên, command bar và gợi ý phím tắt của Linear
• Khung giao diện workspace và các widget tài khoản

Khi nào đây là công cụ đúng: lấy vài issue để viết một bản tổng hợp, gom issue gốc của sự cố cùng toàn bộ issue con cho buổi mổ xẻ, hoặc những việc lẻ cần làm nhanh.

Cách 2: Linear GraphQL API

Với xuất hàng loạt hoặc tích hợp bằng script, GraphQL API của Linear là con đường chuẩn.

Quy trình điển hình:

1. Tạo một API key cá nhân trong Linear → Settings → API
2. POST các truy vấn GraphQL tới https://api.linear.app/graphql với header Authorization: <api-key>
3. Truy vấn issue, bình luận, tệp đính kèm và các issue liên kết
4. Duyệt qua kết quả trả về và xuất ra Markdown

Một truy vấn khởi đầu:

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

Ưu: chạy được bằng chương trình, hỗ trợ lọc và phân trang, hoàn hảo cho những lần xuất lặp lại.

Nhược: bạn phải tự viết phần chuyển sang Markdown, và phải xử lý phân trang với project lớn.

Cách 3: Linear CLI (@linear/cli)

Linear có sẵn một CLI bọc quanh các thao tác GraphQL thông dụng. Hợp với truy vấn nhanh, kém hợp với việc xuất Markdown đầy đủ.

Ví dụ:

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

Kết quả là văn bản thuần hoặc JSON. Đẩy qua một bộ chuyển đổi (một script Node nhỏ, hoặc jq cộng template) để ra Markdown.

Nó toả sáng khi: cần truy vấn nhanh bằng script, hoặc các job CI không đòi hỏi bản xuất trung thực tuyệt đối.

Cách 4: Công cụ xuất có sẵn của Linear

Linear → Settings → Workspace → Export hiện xuất ra một tệp CSV các issue. Hữu ích để phân tích trên bảng tính, nhưng không phải Markdown. Bạn vẫn phải tự viết bước chuyển CSV sang Markdown.

Quy trình cho đội kỹ thuật

Phần lớn người dùng Linear rơi vào một trong ba nhóm.

Nhóm A: «tôi muốn issue này nằm trong ghi chú của mình»

1. Mở issue trong Linear
2. Bấm Minibase trên thanh công cụ Chrome
3. Tệp Markdown rơi vào thư mục tải về → kéo vào Obsidian / Notion / hệ RAG của bạn

Nhóm B: «sinh ghi chú phát hành từ các issue đã đóng trong cycle này»

Dùng GraphQL API:

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

Đẩy sang một script Node để sinh changelog Markdown theo template. Điểm khởi đầu mã nguồn mở: linear-cli-tools.

Nhóm C: «kéo cả một project thành kho lưu trữ Markdown cho bên liên quan»

• Từ 20 issue trở xuống: cứ Minibase từng cái bằng tay (vẫn nhanh).
• Từ 100 issue trở lên: viết script gọi GraphQL API.

Agent AI cần gì ở một bản xuất Linear

Khi mục tiêu là đưa bản xuất cho Claude hoặc ChatGPT tổng hợp:

• Giữ mã định danh issue (ENG-1234) — LLM thường cần trích dẫn lại chính mã đó
• Giữ lại các bước chuyển trạng thái — «Backlog → In Progress → Done trong 3 tuần» nói lên nhiều hơn hẳn một chữ «Done»
• Duỗi luồng bình luận theo trình tự thời gian, đừng gom theo tác giả
• Kèm tiêu đề của issue liên kết, không chỉ mã — «chặn ENG-1230 (luồng onboarding hỏng)» thì hữu ích, «chặn ENG-1230» trơ trọi thì không

Phần trích xuất của Minibase đã làm đủ những việc đó — Linear là site được hỗ trợ ở mức cao nhất và đầu ra được tinh chỉnh để LLM đọc.

Chốt lại cho gọn

• Việc lẻ, 1–10 issue: Minibase. Bản miễn phí lưu không giới hạn, bản Plus (5,99 $/tháng) thêm mẫu AI, lịch sử đã lưu và phiên âm video.
• Sinh changelog định kỳ: một script gọi GraphQL API, chạy từ CI.
• Lưu trữ toàn bộ workspace: GraphQL API cộng một script chuyển đổi, chạy một lần.
• «Quý trước mình chốt X ở đâu nhỉ?»: Minibase ngay issue chứa quyết định đó, thả vào Claude kèm câu «tóm tắt quyết định trong thread này» → có câu trả lời sau 5 giây.

Linear nhanh. Bản xuất của bạn cũng nên vậy.

---

Minibase biến bất kỳ trang web nào thành Markdown sạch chỉ với một cú nhấp, thẳng vào một vault cục bộ mà AI của bạn có thể tìm kiếm. Tiện ích mở rộng miễn phí với số lần lưu không giới hạn; Minibase Plus (5,99 $/tháng hoặc 34,99 $/năm) bổ sung mẫu AI, lịch sử và phiên âm video. minibase.md.