옵시디언-HTML-변환-워크플로우

Obsidian 마크다운 노트를 클릭 한 번에 HTML 페이지로 변환하고 GitHub Pages에 자동 배포해 무료 블로그/문서 사이트로 공유하는 워크플로우. 기본 아이디어는 HTML-as-LLM-출력형식을 실용적 출판 파이프라인으로 실현하는 것.

구성 요소

레이어	도구	역할
콘텐츠	[[wiki/entities/obsidian	Obsidian]] vault
변환 엔진	[[wiki/entities/openai-codex	Codex CLI]] 또는 [[wiki/entities/claude-code
UI 어댑터	Mark-HTML-Exporter (옵시디언 플러그인)	리본 클릭 → CLI 호출 + 옵션 패널 제공
호스팅	GitHub Pages	정적 HTML 무료 배포
댓글	Giscus	GitHub Issues 기반 댓글
인증	GitHub Personal Access Token	Pages 자동 배포·푸시 권한

절차

1. 옵시디언에서 변환할 노트를 연다.
2. 좌측 리본의 Mark Note → HTML 클릭.
3. 템플릿 선택 (Shareable Article / Public Article / Research Report / Memo / Interactive Report 등).
4. 모드 선택 (Blog Article / Preview / Interactive Preview).
5. CLI 백엔드 선택 (Codex CLI 또는 Claude Code CLI).
6. Context Pack 옵션 — wikilink로 연결된 다른 노트까지 함께 변환할지 결정.
7. Giscus 댓글 포함 여부 결정.
8. Export 클릭 → 자동으로 HTML 생성, Git push, Pages 배포.
9. 약 30초 후 GitHub Pages URL이 활성화된다.

비용

• 호스팅: 0원 (GitHub Pages)
• 댓글: 0원 (Giscus + GitHub Issues)
• 변환: Codex / Claude Code 정액 구독료에 포함 (별도 API 발급 불필요)

핵심 설정 포인트

• CLI 타임아웃: 최소 15분 권장 — 복잡한 HTML 아티팩트는 생성에 오래 걸린다.
• CLI 경로: 모를 경우 Codex / Claude Code에게 직접 “내 CLI path 알려줘”라고 물으면 답한다.
• Giscus용 별도 레포지토리: 댓글 시스템 활성화에는 추가 GitHub repository 1개 생성이 필요하다.
• GitHub Token: Pages 배포·Issue 댓글 양쪽에 필요. Personal Access Token으로 발급.

디자인 분기

• Codex CLI 백엔드와 Claude Code CLI 백엔드는 같은 마크다운에서 다른 시각 디자인의 HTML을 생성한다.
• 같은 노트를 양쪽으로 한 번씩 변환해 비교하는 것이 권장된다.

플러그인 설치

• 정식 커뮤니티 플러그인 등록 전이므로 BRAT (Beta Reviewers Auto-update Tool) 을 통해 설치한다.

관련 개념

• HTML-as-LLM-출력형식 — 이 워크플로우의 이론적 동기
• codex-cli
• harness-engineering — CLI를 백엔드 도구로 활용하는 일반 패턴

출처

• yt-LkV03ZxLGG4-옵시디언-HTML-블로그-플러그인