Quip 문서를 Markdown으로 내보내기

Salesforce가 Quip을 접고 있습니다. 팀에 아직 Quip 문서가 남아 있다면 — 많은 엔터프라이즈 팀이 그렇습니다 — 실제로 쓸 수 있는 형식으로 내용을 꺼낼 시간이 정해져 있는 셈입니다. 목적지로는 Markdown이 맞습니다. 이동이 자유롭고, LLM이 읽을 수 있으며, 요즘 쓰는 모든 도구(Notion, Confluence, Obsidian, 정적 사이트 생성기)가 깔끔하게 가져갈 수 있는 형식이니까요.

이 가이드는 현실적인 방법을 하나씩 짚어 봅니다.

왜 Quip을 Markdown으로 내보내야 할까요?

• 제품이 종료됩니다. Salesforce는 Quip의 수명이 끝났음을 알렸습니다. API가 아직 살아 있는 지금 옮기세요.
• 현행 도구로 이사 — Notion, Confluence, Google Docs, SharePoint, 혹은 Git 기반 문서 저장소로.
• AI 워크플로에 넣기 — Claude와 ChatGPT에는 깨끗한 텍스트가 필요합니다. Quip의 내보내기 형식은 잡음이 많습니다.
• 아카이브 — 수년치 조직 지식을 쌓아 왔습니다. 스위치가 내려갈 때 함께 사라지게 두지 마세요.
• 개인의 이동성 — Markdown 파일은 여러분의 파일 시스템에 남아 ripgrep으로 검색되고, 앞으로도 계속 읽힙니다.

방법 1: Minibase Chrome 확장 프로그램 (문서 하나씩)

Minibase는 Quip 문서를 클릭 한 번으로 깔끔한 Markdown으로 바꿉니다.

Minibase가 Quip에서 담아내는 것:

• 문서 제목, 작성자, 마지막 수정일
• 제목 구조가 유지된 본문
• 정렬까지 살린 Markdown 표
• 작성자와 타임스탬프가 붙은, 원래 위치에 담긴 인라인 댓글
• 스프레드시트 셀을 표 데이터로
• 언어 감지가 적용된 코드 블록
• 연결된 Quip 문서를 Markdown URL로
• 삽입된 이미지를 Markdown 참조로

Minibase가 걷어내는 것:

• Quip UI 껍데기: 사이드바, 스레드 패널, 툴바
• 접속 상태 표시와 협업자 아바타

언제 알맞은 도구인가: 문서 하나하나, 읽기 전용으로 공유받은 문서, 정말 아끼는 열몇 개 문서를 즉석에서 옮길 때.

방법 2: Quip 기본 내보내기

Quip은 ⋯ Export 메뉴에서 문서 단위 내보내기를 지원합니다.

• Markdown (.md) — Markdown으로 바로 내보내기
• HTML (.html) — 깔끔한 HTML이라 Pandoc으로 쉽게 변환됩니다
• PDF — 보관용일 뿐, 이사용은 아닙니다

장점: 무료이고, 공식이며, 문서 본문을 잘 처리합니다.

단점: UI에서 한 번에 한 문서씩만 내보낼 수 있어 개수가 많으면 지겹고, 댓글은 본문과 함께 나오지 않으며, 스프레드시트 셀은 표로 들어오지만 수식은 잃습니다.

빛을 발할 때: 워크스페이스 접근 권한이 있는 문서 한두 개.

방법 3: Quip Automation API

대량 내보내기에는 Quip의 Automation API가 스크립트로 가는 길입니다.

일반적인 흐름:

1. https://platform.quip.com/manage/tokens에서 개인 액세스 토큰을 만듭니다
2. GET /1/threads/ → 접근 권한이 있는 모든 스레드(문서, 스프레드시트, 채팅) 목록
3. 스레드마다: GET /1/threads/{thread_id} → 문서의 HTML 내용 가져오기
4. Pandoc이나 Turndown, html-to-md로 HTML을 Markdown으로 변환
5. .md 파일로 저장

curl 예시:

curl -H "Authorization: Bearer $QUIP_TOKEN" \
     https://platform.quip.com/1/threads/THREAD_ID \
     | jq -r '.html' \
     | pandoc -f html -t gfm -o output.md

장점: 대량으로, 스크립트로, 모든 문서에 대해 동작합니다.

단점: API 요청 제한이 있고, HTML을 Markdown으로 바꾸는 품질은 어떤 변환기를 고르느냐에 달려 있습니다.

방법 4: Quip 관리자 일괄 내보내기

엔터프라이즈 Quip 관리자라면 Salesforce가 관리자 콘솔에서 일괄 데이터 내보내기를 제공합니다.

• 경로: Admin Console → Data Export
• 결과물: 워크스페이스의 모든 콘텐츠를 HTML 파일로 담고 메타데이터 색인을 곁들인 .zip

그다음 HTML 파일 전체를 일괄 Markdown 변환기에 태우면 됩니다.

장점: 한 번의 작업으로 전부 다룹니다.

단점: 관리자만 가능하고, 큰 워크스페이스는 처리에 몇 시간이 걸리며, HTML 품질이 들쭉날쭉합니다.

Quip 특유의 문제 다루기

• 스프레드시트는 수식까지 갖춘 본격적인 물건입니다. 내보내기로는 수식이 아니라 셀 값만 나오니 그에 맞게 계획하세요.
• 댓글은 본문의 특정 위치에 묶여 사이드바 패널에 살고 있습니다. Minibase는 이를 본문에 인라인으로 넣고, 기본 내보내기는 빼 버리며, API는 별도 엔드포인트(/1/threads/{id}/comments)로 돌려줍니다.
• Quip “Live Apps”(Jira 이슈나 Salesforce 레코드 같은 삽입형 연동)는 Markdown에서 링크로 렌더링됩니다. 살아 있는 데이터 자체는 옮겨 가지 않습니다.
• 링크로 공유된 문서는 워크스페이스 소속이 아니면 API 토큰에 보이지 않을 수 있습니다. Minibase는 여러분의 브라우저가 볼 수 있는 것을 그대로 담아냅니다.

실용적인 이사 계획

정말 중요한 문서가 50개쯤 된다면:

1. 마지막 수정일 기준으로 50개 목록을 만듭니다 (API 또는 직접 훑기)
2. 하나씩 열어 Minibase를 클릭해 .md 파일로 만듭니다
3. 그 묶음을 Notion이나 Obsidian, 원하는 목적지로 가져옵니다
4. 나머지는 버립니다

문서가 500개가 넘는다면 API와 일괄 스크립트를 쓰세요. 주말 하나를 잡아 두면 됩니다.

Quip 콘텐츠를 LLM이 읽기 좋게 만들기

내보낸 문서를 Claude나 ChatGPT에 넘기려면:

• HTML을 직접 내보냈다면 Quip 고유의 data-* 속성을 걷어내세요
• 제목 계층을 유지하세요 — LLM은 ## / ### 구조를 따라 움직입니다
• 위치에 묶인 댓글을 포함하세요 — 가장 중요한 맥락이 거기 담겨 있을 때가 많습니다
• 협업자 메타데이터를 눌러 담으세요 — <user id="12345">를 실제 사람 이름으로 바꾸세요

Minibase는 이미 이 모든 것을 처리합니다. 기본 내보내기나 API 기반 흐름은 후처리가 필요합니다.

결론

Quip의 종료는 현실입니다. 기다리는 달마다 조직의 지식이 위험에 놓입니다. 목표 형식이 Markdown인 이유는, 요즘의 모든 목적지가 그 말을 알아듣기 때문입니다.

• 즉석 이사 (문서 1~50개): 문서마다 Minibase 확장 프로그램 — 빠르고, 무제한 저장이 무료입니다. Plus(월 $5.99)는 AI 템플릿과 저장 기록, 영상 전사를 더해 줍니다
• 대량 이사 (문서 50~500개): Automation API + Pandoc 파이프라인 — 오후 한나절의 스크립트 작업
• 워크스페이스 전체 아카이브: 관리자 일괄 내보내기 + 일괄 변환기 — 한 번으로 끝나는 작업
• Quip에 있는 콘텐츠를 지금 당장 Claude에 넘기고 싶다면: Minibase — 출력이 이미 LLM에 맞춰져 있습니다

종료 공지를 기다리지 마세요. 오늘 여러분의 콘텐츠를 Markdown으로 손에 넣으세요.