Google Docs를 Markdown으로 내보내기

대부분의 팀이 글을 쓰는 곳은 Google Docs입니다. 하지만 그 내용을 정적 사이트 생성기나 LLM 프롬프트, Obsidian 보관함, Markdown 중심 CMS에 넣어야 하는 순간 같은 벽에 부딪힙니다. Docs는 Markdown으로 깔끔하게 내보내 주지 않는다는 벽입니다.

이 가이드는 가장 빠른 방법(클릭 한 번)부터 가장 통제력이 큰 방법(스크립트로 API 접근)까지 모두 짚고, 각각의 특이한 점도 함께 다룹니다.

왜 Google Docs를 Markdown으로 내보내야 할까요?

팀이 Docs의 내용을 밖으로 꺼내는 흔한 이유는 이렇습니다.

• AI 워크플로에 넣기 — LLM을 헷갈리게 하는 서식 찌꺼기 없이, Claude나 ChatGPT, Gemini에 깨끗한 문서 맥락을 넘기기 위해
• 정적 사이트에 퍼블리싱 — 요즘 사이트 생성기(Astro, Hugo, MkDocs, Docusaurus, Jekyll)는 대부분 Markdown을 기대합니다
• 개인 지식 베이스 구축 — Obsidian, Logseq, Foam은 모두 노트를 Markdown 파일로 저장합니다
• 편집기에서 벗어나기 — Google의 버전 기록에 기대는 대신 Git으로 글을 버전 관리하기
• 아카이브와 백업 — Markdown은 평범한 텍스트라 어디로든 옮겨 가고, Google Workspace 계정이 만료돼도 인질로 잡히지 않습니다

방법 1: Minibase Chrome 확장 프로그램 (클릭 한 번)

개별 문서에는 Minibase가 가장 빠른 길입니다. 확장 프로그램을 설치하고, 문서를 열고, 아이콘을 클릭하면 .md 파일이 나옵니다.

Minibase가 담아내는 것:

• 제목 계층이 유지된 문서 제목과 본문 (H1H6이 #######로 대응됩니다)
• 중첩 목록을 포함한 글머리 기호 목록과 번호 목록
• 제대로 된 Markdown 표로 렌더링된 표
• 인라인 이미지를 Markdown 이미지 참조로
• 작성자와 타임스탬프가 붙은, 원래 위치에 담긴 인라인 댓글
• 굵게, 기울임, 밑줄(강조로 변환), 취소선
• 고정폭 서식에서 감지한 코드 블록

Minibase가 걷어내는 것:

• Google Docs 껍데기 (툴바, 눈금자, 탐색 패널)
• 협업자 접속 표시와 아바타
• 버전 기록 UI

빛을 발할 때: 개별 문서, 빠른 내보내기, 읽기 전용으로 공유받은 콘텐츠 다루기. 무료에서도 무제한 저장이 되고, 월 $5.99의 Minibase Plus는 AI 템플릿과 저장 기록, 영상 전사를 열어 줍니다.

방법 2: Docs 기본 “Markdown으로 다운로드”

Google Docs는 2024년 말에 Markdown 내보내기를 기본 기능으로 추가했습니다. 파일 → 다운로드 → Markdown (.md) 에서 쓸 수 있습니다.

장점: 무료이고, 공식이며, 확장 프로그램이 필요 없습니다.

단점: 몇 가지를 놓칩니다.

• 댓글이 내보내기에 포함되지 않습니다
• 복잡한 표는 열 너비나 정렬을 잃을 때가 있습니다
• 제안 모드의 수정은 소리 없이 눌러 담깁니다
• 이미지 참조가 인증이 필요한 Google 호스팅 URL을 가리킵니다 (직접 호스팅하는 사이트에는 좋지 않습니다)

빛을 발할 때: 댓글이 필요 없고 이미지를 다시 업로드해도 괜찮은 일회성 내보내기.

방법 3: Docs-to-Markdown Google Apps Script

대량 내보내기나 기존 자동화 파이프라인과의 연동에는 Ed Bacher가 만든 Docs to Markdown이 고전적인 오픈소스 선택지입니다. Docs 안에서 도는 Google Apps Script로, Markdown과 HTML을 함께 내보냅니다.

설치: 10분쯤 걸립니다. 확장 프로그램 → Apps Script에 스크립트를 붙여 넣고, 권한을 승인한 뒤, 사이드바에서 실행합니다.

장점: 무료이고, 스크립트로 다룰 수 있으며, 복잡한 문서를 대체로 잘 처리하고, 댓글을 보존합니다.

단점: Apps Script 권한이 필요하고, UI가 낡았으며, 중첩된 표에서 예외 상황이 있습니다.

빛을 발할 때: Chrome 확장 프로그램을 설치할 수 없는 환경(통제가 엄격한 회사 노트북)에서 반복적으로 내보낼 때.

방법 4: Google Docs API + 직접 만든 파이프라인

완전한 프로그램 제어가 필요하다면 Google Docs API가 문서 구조 전체를 JSON으로 열어 줍니다. 이렇게 하면 됩니다.

1. OAuth 2.0이나 서비스 계정으로 인증합니다
2. documents.get을 호출해 문서 구조를 가져옵니다
3. body.content 트리를 순회하며 Markdown으로 출력합니다

google-docs-to-markdown(TypeScript) 같은 라이브러리가 순회 작업을 대신해 줍니다.

장점: 완전한 제어, 일괄 내보내기, CI 파이프라인 연동.

단점: 인증 설정(OAuth 또는 서비스 계정), 요청 제한, 개발자가 필요합니다.

빛을 발할 때: 문서 100개 이상을 정기적으로 내보낼 때, 사내 도구를 만들 때, Workspace 전체를 정적 사이트로 옮길 때.

네 가지 방법 비교

방법	속도	비용	이미지	댓글	표
Minibase 확장 프로그램	⚡ 즉시	무료 → 월 $5.99	✅ 링크됨	✅ 인라인	✅ 깔끔
Markdown으로 다운로드	빠름	무료	⚠️ Google 호스팅	❌	⚠️ 들쭉날쭉
Docs-to-Markdown 스크립트	보통	무료	✅	✅	✅
Google Docs API	설치가 느림	개발 시간	경우에 따라	경우에 따라	경우에 따라

AI 엔진이 원하는 것

문서 내용을 LLM에 넘기는 것이 최종 목표라면, 특별히 신경 쓸 만한 추출 항목이 몇 가지 있습니다.

• 제목 계층을 지키세요. RAG에서 LLM은 ##과 ### 구조로 관련 구간을 찾아갑니다.
• 표는 Markdown 표로 보존하세요. 파이프로 구분된 표가 문단 산문으로 바뀐 것보다 훨씬 효율적으로 토큰화됩니다.
• 편집 기록과 리뷰 스레드는 버리세요. 컨텍스트 창을 부풀리는 잡음입니다.
• 댓글은 원래 위치에 붙여 두세요. 가장 중요한 결정이 거기 담겨 있을 때가 많습니다.

Minibase의 추출은 정확히 이 지점에 맞춰져 있습니다. 자기 노트를 매일 Claude나 ChatGPT에 넘기는 연구자와 프로덕트 매니저, 개발자들이 쓰고 있습니다.

대부분의 팀에게 가장 빠른 작업 흐름

문서 1~10개를 지금 깔끔한 Markdown으로 만들고 싶다면:

1. Chrome용 Minibase를 설치합니다
2. 문서를 하나씩 엽니다
3. Minibase를 클릭합니다
4. 끝입니다. .md 파일을 Obsidian이나 Notion, 저장소, Claude로 끌어다 놓으세요

수백 개의 문서를 정기적으로 내보내야 한다면, 기존 파이프라인에 Google Docs API를 스크립트로 붙이세요.

어느 쪽이든, 여러분은 자기 콘텐츠를 되찾게 됩니다. 그것도 모든 도구가 읽을 수 있는 형식으로요.