Obsidian 노트를 PDF, Word, HTML로 내보내는 방법

Obsidian은 수백만 명이 사용하는 대표적인 마크다운 기반 노트 앱입니다. 개인 지식 관리, 기술 문서 작성, 프로젝트 관리까지 다양하게 활용되고 있죠. 하지만 노트를 다른 사람에게 공유해야 할 때 문제가 생깁니다.

팀장님은 Word 문서를 요청하고, 클라이언트에게는 PDF를 보내야 하며, 블로그에는 HTML이 필요합니다. 그런데 Obsidian의 기본 내보내기 기능은 스타일 조절이 안 되는 단순한 PDF만 지원하고, Word 변환은 아예 불가능합니다.

이 글에서는 Obsidian 노트를 PDF, Word, HTML로 깔끔하게 내보내는 실전 방법을 단계별로 정리했습니다.

Obsidian 기본 내보내기의 한계

Obsidian 노트 에디터의 제한된 내보내기 옵션 메뉴

Obsidian에는 기본적으로 "PDF로 내보내기" 기능이 있습니다 (점 세 개 메뉴 → Export to PDF). 간단한 메모에는 괜찮지만, 다음과 같은 콘텐츠가 포함되면 결과물이 크게 달라집니다:

표(테이블) — 셀 내용이 길면 열 너비가 무너지는 경우가 많습니다
코드 블록 — 구문 강조가 일관되지 않거나 아예 적용되지 않습니다
이미지 — ![[image.png]] 형식의 로컬 이미지가 내보내기에서 표시되지 않을 수 있습니다
콜아웃 — Obsidian 전용 기능이라 표준 PDF로 변환되지 않습니다
위키링크 — [[페이지 이름]] 링크가 일반 텍스트로 바뀝니다

Word나 HTML로의 내보내기는 기본 기능 자체가 없습니다. 결국 Google Docs나 Microsoft Word에 복사-붙여넣기를 하게 되는데, 그때마다 서식이 깨져버립니다.

내보내기 전 마크다운 정리하기

변환 결과의 품질은 원본 마크다운의 상태에 크게 좌우됩니다. 변환 전에 다음 사항을 점검해 주세요.

Obsidian 전용 구문 변환

Obsidian 위키링크 구문과 표준 마크다운 구문의 비교

Obsidian은 표준 마크다운을 자체적으로 확장한 구문을 사용합니다. 볼트 안에서는 잘 작동하지만 외부 도구로 변환할 때 문제가 됩니다:

Obsidian 구문	표준 마크다운 대체 구문
`![[image.png]]`	`![대체 텍스트](image.png)`
`[[페이지 이름]]`	`[페이지 이름](page-name.md)`
`> [!note]` 콜아웃	`> 참고: 텍스트` 인용문
`==하이라이트==`	`하이라이트` 또는 HTML `<mark>`

단일 노트라면 수동으로 변환할 수 있고, 대량 내보내기 시에는 Obsidian Markdown Export 커뮤니티 플러그인을 활용하면 자동으로 정리됩니다.

표준 구문과 확장 구문의 차이를 더 자세히 알고 싶다면 마크다운 기본 구문 가이드와 확장 구문 레퍼런스를 참고하세요.

이미지 경로 확인

내보내기 실패의 가장 흔한 원인이 바로 이미지입니다. Obsidian은 이미지를 볼트 폴더에 저장하는데, 외부 변환 도구에서 접근하려면 다음 조건을 충족해야 합니다:

위키링크 임베드가 아닌 상대 경로로 실제 파일을 가리킬 것
변환 도구가 접근할 수 있는 위치에 이미지 파일이 있을 것
특수 포맷이라면 PNG 또는 JPEG 등 범용 포맷으로 변환할 것

방법 1: Obsidian 노트를 PDF로 내보내기

Obsidian 마크다운 노트가 전문적인 PDF 문서로 변환된 모습

PDF는 가장 많이 사용되는 내보내기 형식입니다. 레이아웃이 그대로 유지되고 어디서든 열 수 있다는 장점이 있습니다.

방법 A: 온라인 변환기 (대부분의 사용자에게 추천)

가장 빠르고 결과물 품질도 우수한 방법입니다:

Obsidian에서 노트를 엽니다
전체 내용을 복사하거나 (Cmd/Ctrl + A → Cmd/Ctrl + C), 볼트 폴더에서 .md 파일을 찾습니다
Markdown to PDF 변환기에 접속합니다
내용을 붙여넣거나 .md 파일을 업로드합니다
변환된 PDF를 다운로드합니다

Obsidian 기본 내보내기와 비교했을 때, 표 서식이 정확하고 코드 블록에 구문 강조가 적용되며 전반적인 스타일링이 일관됩니다.

방법 B: Pandoc (개발자용)

커맨드라인에 익숙하다면 Pandoc으로 세밀하게 제어할 수 있습니다:

pandoc "My Obsidian Note.md" -o output.pdf \
  --pdf-engine=xelatex \
  --variable geometry:margin=1in

주의할 점:

LaTeX가 설치되어 있어야 합니다 (Mac: MacTeX, Linux: TeX Live)
이미지 경로는 명령어를 실행하는 위치 기준 절대/상대 경로여야 합니다
위키링크는 인식되지 않으므로 반드시 표준 링크로 변환하세요

방법 C: Obsidian 커뮤니티 플러그인

Better Export PDF 플러그인은 기본 내보내기보다 다음 기능을 추가로 지원합니다:

커스텀 CSS 스타일 적용
머리글 및 바닥글 설정
페이지 번호 삽입

설치 경로: 설정 → 커뮤니티 플러그인 → 찾아보기 → "Better Export PDF" 검색

방법 2: Obsidian 노트를 Word(.docx)로 내보내기

Obsidian 마크다운 노트가 서식이 적용된 Word 문서로 변환된 모습

Obsidian에는 Word 내보내기 기능이 없습니다. 실제로 사용할 수 있는 방법을 소개합니다.

방법 A: 온라인 변환기 (가장 빠른 방법)

볼트 폴더에서 노트의 .md 파일을 찾습니다 (Obsidian에서 노트 우클릭 → "Finder/탐색기에서 열기")
Markdown to Word 변환기에 파일을 업로드합니다
.docx 파일을 다운로드합니다

변환 결과물은 Word의 기본 스타일 (제목 1, 제목 2, 본문 등)이 올바르게 적용되어 있어서 Word 테마만 바꾸면 바로 원하는 디자인을 적용할 수 있습니다.

방법 B: Pandoc

pandoc "My Obsidian Note.md" -o output.docx

회사 브랜딩이 적용된 커스텀 Word 템플릿을 사용하려면:

pandoc "My Obsidian Note.md" -o output.docx --reference-doc=company-template.docx

마크다운 제목이 템플릿의 제목 스타일에 자동으로 매핑되어 일관된 브랜딩을 유지할 수 있습니다.

Word와 PDF, 언제 무엇을 선택할까

Word가 적합한 경우:

받는 사람이 문서를 편집하거나 변경 내용 추적으로 댓글을 달아야 할 때
.docx 형식이 필수인 시스템에 제출할 때 (학위 논문, 연구비 신청서 등)
문서가 검토 및 승인 절차를 거쳐야 할 때

PDF가 적합한 경우:

최종본으로 수정 불가한 버전이 필요할 때
어떤 기기에서든 동일하게 보여야 할 때
인쇄하거나 보관용으로 남겨야 할 때

방법 3: Obsidian 노트를 HTML로 내보내기

HTML 내보내기는 웹 게시, CMS 플랫폼 삽입, 문서 사이트 구축 등에 활용됩니다.

방법 A: 온라인 변환기

노트 내용을 복사하거나 .md 파일을 내보냅니다
Markdown to HTML 변환기에서 변환합니다
웹사이트나 CMS에 바로 사용할 수 있는 깔끔한 HTML을 받습니다

방법 B: Pandoc

pandoc "My Obsidian Note.md" -o output.html --standalone

--standalone 플래그를 사용하면 <head>와 <body> 태그가 포함된 완전한 HTML 페이지가 생성됩니다. 이 플래그 없이 실행하면 기존 페이지에 삽입하기 좋은 HTML 조각만 출력됩니다.

방법 C: Obsidian Publish (유료)

Obsidian에서 자체 제공하는 호스팅 서비스인 Obsidian Publish(월 $8)를 사용하면 노트를 네비게이션, 검색, 그래프 뷰가 포함된 웹사이트로 배포할 수 있습니다. 편리하지만 플랫폼에 종속되고 원본 HTML 파일을 직접 받을 수 없다는 단점이 있습니다.

자주 발생하는 내보내기 문제와 해결법

문제: 이미지가 내보내기에서 누락됨

원인: Obsidian의 ![[image.png]] 위키링크 구문을 외부 도구가 인식하지 못합니다.

해결: 표준 마크다운 이미지 구문으로 변환하세요:

![이미지 설명](./attachments/image.png)

온라인 변환기를 사용하는 경우, 이미지를 별도로 업로드하거나 공개 URL을 사용하세요.

문제: 표가 깨져서 출력됨

원인: 셀 내용이 너무 길면 PDF 출력 시 열이 넘칩니다.

해결: 셀 내용을 간결하게 유지하세요. 데이터가 복잡한 경우:

여러 개의 작은 표로 분리하기
표 대신 글머리 기호 목록 사용하기
셀 내에서 줄바꿈 추가하기 (일부 변환기에서 지원)

문제: Obsidian에서 보던 것과 서식이 다름

원인: Obsidian은 자체 CSS 테마를 적용하기 때문에 외부 도구와 스타일이 다릅니다.

해결: 이는 정상적인 현상입니다. 픽셀 단위의 시각적 일치보다는 제목, 목록, 코드 블록 등 구조적 정확성에 집중하세요. PDF 변환기 중에는 커스텀 CSS를 적용할 수 있는 도구도 있습니다.

실전 워크플로우: 주간 보고서 예시

실제로 Obsidian에서 주간 보고서를 작성하고 배포하는 워크플로우를 공유합니다:

Obsidian에서 작성 — 위키링크나 콜아웃을 사용하지 않는 표준 마크다운 템플릿을 활용합니다
읽기 모드에서 검토 — Reading View로 전환하여 서식 문제를 확인합니다
.md 파일 내보내기 — 볼트 폴더에서 해당 파일을 꺼냅니다
PDF로 변환 — Markdown to PDF 변환기로 보관용 문서를 만듭니다
Word로 변환 — Markdown to Word 변환기로 팀 리뷰용 문서를 만듭니다

전체 소요 시간은 3분 이내입니다. 같은 작업을 Word에서 직접 하면 15~20분은 서식 정리에 써야 합니다.

내보내기 방법 비교

Obsidian 노트의 세 가지 내보내기 방법 비교 다이어그램: 온라인 변환기, Pandoc, 커뮤니티 플러그인

항목	온라인 변환기	Pandoc	커뮤니티 플러그인
초기 설정	불필요	설치 필요	플러그인 설치
사용 편의성	드래그 앤 드롭	커맨드라인	앱 내 메뉴
지원 포맷	PDF, Word, HTML	40개 이상	플러그인에 따라 다름
커스텀 스타일	제한적	완전한 제어	보통 수준
대량 처리	한 번에 하나씩	스크립트 자동화 가능	보통 한 번에 하나씩
추천 대상	빠른 단건 변환	자동화된 워크플로우	Obsidian 안에서 해결

대부분의 사용자에게는 온라인 변환기가 별도 설정 없이 내보내기 필요의 90%를 해결해 줍니다. 자주 내보내기를 하는 파워 유저라면 Pandoc 워크플로우를 구축하는 것이 효율적입니다.

정리

Obsidian은 훌륭한 글쓰기 도구이지만, 작성한 노트를 다른 사람과 공유하려면 약간의 추가 작업이 필요합니다. 상황에 맞는 방법을 선택하는 것이 핵심입니다:

PDF — 최종 확정 문서가 필요할 때 → 여기서 변환
Word — 공동 편집이 필요할 때 → 여기서 변환
HTML — 웹 게시가 필요할 때 → 여기서 변환

어떤 형식으로 내보내든 Obsidian 전용 구문을 먼저 정리하는 것이 중요합니다. 변환 전 몇 분의 준비가 내보내기 후 발생할 수 있는 문제를 크게 줄여줍니다.

더 많은 변환 기법은 Markdown PDF 변환 완벽 가이드와 Markdown Word 변환 가이드를 참고하세요.