OneNote를 Markdown으로 내보내기

Microsoft 365 사용자 대부분의 가장 좋은 생각은 OneNote에 살고 있습니다. 회의 노트, 개인 일지, 프로젝트 계획, 조사 자료 같은 것들이죠. 그런데 그 내용을 다른 곳으로 — Obsidian이나 Notion, Git 저장소, AI 프롬프트로 — 옮기려 하면 OneNote의 독점 형식이 발목을 잡습니다.

이 가이드는 2026년에 실제로 통하는 방법을 모두 다룹니다.

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

• Markdown 중심 도구로 이사 — Obsidian, Logseq, Foam, 또는 Git 기반 문서 환경
• AI 워크플로에 넣기 — Claude와 ChatGPT에 필요한 건 OneNote의 XML 덩어리가 아니라 평범한 텍스트입니다
• 아카이브 — 전자 필기장이 OneDrive에 동기화되긴 하지만, 그 형식은 여러분의 것이 아닙니다
• 플랫폼을 가리지 않는 접근 — Linux에서 OneNote는 괴롭지만 Markdown 파일은 어디서나 열립니다
• 평범한 텍스트 검색 — Markdown 폴더를 ripgrep으로 훑는 편이 OneNote의 어림짐작 검색보다 언제나 낫습니다

방법 1: Minibase Chrome 확장 프로그램 (OneNote 웹 앱에서)

Minibase는 onenote.com에서 동작하며, OneNote 페이지를 클릭 한 번으로 깔끔한 Markdown으로 담아냅니다.

Minibase가 OneNote에서 담아내는 것:

• 페이지 제목, 섹션, 전자 필기장
• 마지막 수정 타임스탬프
• 제목 계층이 살아 있는 페이지 본문 전체
• 중첩을 포함한 글머리 기호 목록과 번호 목록
• Markdown 표로 렌더링된 표
• 인라인 이미지를 Markdown 참조로
• 삽입된 파일을 Markdown URL 링크로
• GitHub 방식 Markdown 작업 목록으로 유지되는 체크리스트
• Markdown 강조로 표현되는 형광펜 텍스트

Minibase가 걷어내는 것:

• OneNote의 탐색 창과 리본
• 그리기 주석 (OneNote의 잉크 → 이미지 참조로 담김)
• 공동 작성자의 접속 표시

언제 알맞은 도구인가: 페이지 하나하나, 웹 앱에서 작업할 때(Minibase가 도는 환경입니다), AI 프롬프트에 쓰려고 빠르게 뽑아낼 때.

방법 2: Microsoft Graph API

스크립트로 대량 내보내기를 하려면 Microsoft Graph OneNote API가 전자 필기장과 섹션, 페이지를 열어 줍니다.

일반적인 흐름:

1. Notes.Read 또는 Notes.Read.All 권한으로 Azure AD 앱을 등록합니다
2. OAuth나 디바이스 코드 방식으로 토큰을 받습니다
3. GET /me/onenote/notebooks → 전자 필기장 목록
4. GET /me/onenote/sections → 섹션 목록
5. GET /me/onenote/pages → 필터를 걸어 페이지 목록
6. GET /me/onenote/pages/{id}/content → 페이지 HTML 가져오기
7. Pandoc이나 Turndown으로 HTML을 Markdown으로 변환

장점: 전자 필기장 전체를 다루고, 스크립트로 짤 수 있으며, 정기 작업이 가능합니다.

단점: 인증 설정이 필요하고, 규모가 커지면 제한이 걸리며, 그림과 수식에 대해서는 HTML→Markdown 단계를 다듬어야 합니다.

방법 3: 데스크톱 OneNote + Word로 내보내기 + Pandoc

기술적으로는 소박하지만 믿음직한 길입니다.

1. OneNote 데스크톱을 열고 → 섹션 → 내보내기 → Word (.docx)
2. Pandoc을 실행합니다: pandoc input.docx -f docx -t gfm -o output.md
3. 결과를 정리합니다 (이미지는 media/image1.png 참조로 떨어집니다)

장점: API 설정이 필요 없고, 수식을 포함해 대부분의 내용을 처리합니다.

단점: 손이 가고, 체크리스트를 잃으며(평범한 글머리 기호가 됩니다), 한 번에 섹션 하나씩만 됩니다.

방법 4: onenote-to-markdown 커뮤니티 도구

OneNote를 겨냥한 오픈소스 프로젝트들입니다.

• Evernote2Md — OneNote를 먼저 Evernote로 내보낸 뒤, 이 도구로 Evernote를 Markdown으로 바꿉니다. 두 단계를 거치지만 검증된 방법입니다.
• onenote-md-exporter — .NET으로 OneNote를 Markdown으로 곧장 변환합니다. 대량 처리가 가능하고 첨부도 보존합니다.
• Pandoc + DOCX 파이프라인 — 위에서 설명한 방식입니다.

빛을 발할 때: 충실도보다 속도가 중요한, 큰 개인 OneNote 아카이브의 대량 이사.

OneNote 특유의 문제 다루기

• 그림 / 잉크 — Minibase는 이미지 참조로 담아냅니다. 스크립트 내보내기에서 그 안의 글씨가 필요하다면 OCR이 필요합니다.
• 수식 — 원본은 LaTeX지만 내보내기에서는 이미지나 MathML로 렌더링됩니다. 플래그를 파고들면 Pandoc이 MathML→LaTeX 변환을 처리해 줍니다.
• 중첩 페이지(OneNote의 상위/하위 페이지 구조) — 나중에 찾아보기 쉽도록 출력 폴더 구조에 그 위계를 그대로 옮기세요.
• 인쇄물(페이지로 삽입된 PDF) — 내보내기에서는 내용이 아니라 첨부 링크가 됩니다. 글씨가 필요하면 따로 OCR로 뽑아내세요.

실제 작업 흐름

대부분의 사용자에게는 이렇습니다.

• “이 OneNote 페이지 하나를 내 노트에 넣고 싶다” → onenote.com에서 열고 Minibase를 클릭하면 끝.
• “개인 전자 필기장 전체를 옮기고 싶다” → onenote-md-exporter나 DOCX + Pandoc 경로를 쓰세요. 2~4시간을 잡아 두면 됩니다.
• “팀 공유 전자 필기장을 정기적으로 아카이브하고 싶다” → Microsoft Graph API와 야간 크론.
• “이 페이지를 지금 당장 Claude 컨텍스트로 쓰고 싶다” → Minibase. 출력이 이미 LLM에 넣기 좋게 최적화되어 있습니다.

LLM이 OneNote 내보내기에서 원하는 것

페이지를 Claude나 ChatGPT에 넘기는 것이 최종 목표라면:

• 표는 Markdown 표로 펼치세요. OneNote의 시각적 표 형식은 이미지로는 토큰화가 잘 되지 않습니다.
• 페이지 껍데기는 버리세요(섹션 탭, 사이드바의 페이지 제목). 내용만 남기세요.
• 체크리스트 상태를 보존하세요. “- [x] 배포”는 정보지만 “배포”만으로는 쓸모가 덜합니다.
• 페이지 제목과 전자 필기장 맥락을 프런트매터에 넣으세요. LLM이 지금 무슨 파일을 읽는지 알 수 있게요.

Minibase는 이것들을 기본으로 처리합니다. 스크립트 내보내기는 후처리 단계가 필요합니다.

결론

OneNote는 훌륭한, 그러나 갇힌 환경입니다. 주요 노트 도구 가운데 내보내기 이야기가 가장 나쁩니다. Markdown이 그 문을 엽니다.

• 즉석 페이지 내보내기: onenote.com에서 Minibase. 페이지당 5초.
• 전자 필기장 대량 이사: onenote-md-exporter 또는 Graph API + Pandoc.
• 정기 아카이브: Graph API와 예약 작업.

여러분의 노트는 여러분의 것입니다. 10년 뒤에도 열리는 형식으로 옮겨 두세요.