Obsidian에서 WeChat으로 발행하기: 내가 플러그인을 만든 방법

📌 편집자 주: 이 글은 원래 WeChat Publisher에 무료 버전과 유료 버전이 있을 때 작성되었습니다. v0.1.13부터 WeChat Publisher는 개인 사용자에게 완전 무료입니다. 모든 기능(형식 미리보기, HTML 복사, 초안 발행, 다중 계정, 커버 시스템 등)이 활성화 코드 없이 바로 사용 가능합니다. 이에 따라 이 글에서 유료/활성화 코드 관련 내용을 제거했습니다. 원문 스크린샷에는 여전히 ‘활성화 구매’ 버튼이 보일 수 있으나, 새 버전에서는 해당 항목이 제거되었으니 무시해 주세요.

지난 장에서는 Obsidian에서 관리와 운영에 사용할 수 있는 도구들을 다뤘습니다. 이번 마지막 장은 방향을 바꿔서, Obsidian에서 작성한 글을 WeChat에 발행하는 방법을 소개합니다.

글을 다 썼습니다. 이제 어떻게 WeChat에 발행할까요?

이 단계에서 많은 사람들이 막힙니다. 글을 못 써서가 아니라, 쓰고 나서 발행을 못 하거나 형식이 완전히 깨지기 때문입니다.

이 장에서는 그 문제를 해결하고, 제가 직접 만든 플러그인인 WeChat Publisher를 소개합니다.

솔직히 말하면, 이 플러그인을 만드는 데 며칠을 틈틈이 투자했습니다. 복잡하지 않을 거라고 생각했는데, 막상 시작해 보니 예상보다 훨씬 많은 함정이 있었습니다. WeChat API의 다양한 제한, 이미지 형식 변환, HTML 인라인 스타일 호환성 문제 등 하나하나 부딪혔습니다. 다행히 결과물은 꽤 괜찮고, 한동안 사용해 보니 확실히 많은 번거로움이 줄었습니다.

플러그인을 공개하는 게 이렇게 번거로운 일인 줄 몰랐습니다!

Obsidian에서 WeChat용 글을 쓸 때의 문제점

많은 사람들이 겪는 상황부터 시작해 보겠습니다.

Obsidian에서 글을 씁니다. 코드 블록, 굵은 제목, 표 등이 있어 Obsidian에서는 멋져 보입니다. 그런데 내용을 복사해서 WeChat 공식 계정 편집기에 붙여넣으면 모든 것이 엉망이 됩니다. 코드 블록은 일반 텍스트가 되고, 제목 계층은 사라지며, 이미지는 하나하나 수동으로 업로드해야 합니다.

마치 Word에서 아름답게 문서를 작성했는데, 받는 사람이 열어보니 깨져 있는 것과 같습니다.

보통 두 가지 방법이 있습니다.

방법 1: WeChat 편집기에서 직접 작성. 형식 문제는 없지만, 편집기가 Markdown을 지원하지 않아 작성하기가 고통스럽습니다.

방법 2: Obsidian에서 작성하고 편집기에 붙여넣은 후 수동으로 형식 수정. 형식은 올바르게 되지만, 글 하나당 이 단계에 20~30분이 소요됩니다.

더 나은 방법이 있을까요? 네, 있습니다.

WeChat Publisher란 무엇인가?

요약하자면: Obsidian에서 작성하고, WeChat 형식을 바로 미리보기하며, 원클릭으로 WeChat 초안함에 발행합니다.

이 플러그인이 해주는 일: Markdown을 WeChat 호환 HTML로 렌더링하고, 로컬 이미지를 WeChat CDN에 업로드하며, Mermaid 다이어그램과 수학 공식을 이미지로 변환하고, 전체 글을 초안함에 푸시합니다. 여러분은 WeChat 백엔드에서 마지막 단계인 글 보내기만 하면 됩니다.

결과를 한번 보세요.

코드 블록 (구문 강조):

수학 공식 및 Mermaid 다이어그램:

Ruby 주석 및 가로 스크롤 이미지:

이 모든 것이 Obsidian에서 직접 전송되었으며, 수동으로 형식을 조정할 필요가 없었습니다.

핵심 기능 한눈에 보기

개인 사용자에게 완전 무료입니다. 상업적 사용(기업, 교육 기관, 재배포 등)의 경우 WeChat 계정 ‘HelloRanceLee’로 저자에게 연락하여 승인을 받으시기 바랍니다.

설치 방법

이 플러그인은 아직 Obsidian 공식 플러그인 마켓에 등록되지 않았습니다. 두 가지 설치 방법이 있습니다.

방법 1: BRAT을 통한 설치 (권장)

BRAT은 Obsidian 커뮤니티의 플러그인 관리 도구로, 마켓에 없는 플러그인을 설치하고 업데이트를 자동으로 관리해 줍니다.

1단계: BRAT 설치.

Obsidian에서 ‘설정’ → ‘커뮤니티 플러그인’ → ‘찾아보기’로 이동하여 BRAT을 검색하고 설치 및 활성화합니다.

2단계: WeChat Publisher 추가.

‘설정’ → ‘BRAT’을 열고 베타 플러그인 추가를 클릭한 후 저장소 URL을 입력합니다:

RanceLee233/wechat-publisher

플러그인 추가를 클릭하고 Latest version을 선택하면 BRAT이 자동으로 다운로드합니다.

3단계: 플러그인 활성화.

‘설정’ → ‘커뮤니티 플러그인’으로 돌아가 WeChat Publisher를 찾아 활성화합니다.

새 버전이 출시되면 BRAT이 자동으로 감지하거나, 수동으로 업데이트 확인을 클릭할 수 있습니다.

방법 2: 수동 설치

GitHub 접속이 불편하다면 제 블로그에서 직접 zip 파일을 다운로드할 수 있습니다:

https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

압축을 푼 후 폴더를 Obsidian 플러그인 디렉터리에 넣습니다:

your-vault-path/.obsidian/plugins/wechat-publisher/

디렉터리 구조는 다음과 같아야 합니다:

.obsidian/
  plugins/
    wechat-publisher/
      main.js
      manifest.json
      styles.css

그런 다음 ‘커뮤니티 플러그인’에서도 활성화합니다.

플러그인 열기

설치 후 Obsidian 왼쪽 사이드바에 WeChat Publisher 아이콘이 나타납니다. 클릭하여 엽니다. 또는 Cmd+P (Windows: Ctrl+P)를 누르고 WeChat Publisher를 검색할 수도 있습니다.

상단 도구 모음은 왼쪽부터 형식 · 계정 이름 · 계정 설정 · 사용자 가이드 · 렌더링 새로고침 · HTML 복사 · WeChat 붙여넣기로 이동 · 초안 발행입니다.

도구 모음 아래에는 발행 정보 영역(제목, 작성자, 커버)이 있고, 그 아래에는 글 미리보기 영역이 있습니다.

이전 버전의 스크린샷에는 여전히 ‘활성화 구매’ 버튼이 보일 수 있지만, 새 버전에서는 제거되었습니다. 모든 기능을 바로 사용할 수 있습니다.

사용법 1: HTML 복사 후 붙여넣기 (API 설정 불필요)

가장 간단한 사용법으로, 계정 설정이 필요 없습니다. 바로 작성하고 발행할 수 있습니다.

1단계: 형식 조정 (선택 사항).

상단의 형식 버튼을 클릭하여 스타일 제어 막대를 펼칩니다. 내장 테마를 전환하거나 스타일 설정으로 들어가 글꼴 크기, 줄 간격, 색상 등의 세부 사항을 조정할 수 있습니다.

처음에 마음에 드는 스타일을 설정하고 저장해 두는 것이 좋습니다. 이후 글에서는 ‘저장된 스타일 적용’을 바로 사용하여 매번 재설정할 필요가 없습니다.

2단계: ‘HTML 복사’ 클릭.

플러그인이 렌더링된 HTML을 클립보드에 형식 그대로 복사합니다.

3단계: ‘WeChat 붙여넣기로 이동’ 클릭.

브라우저가 자동으로 WeChat 백엔드를 열고, 편집기에 붙여넣을 수 있습니다.

전체 과정은 약 10초 정도 소요되며, 수동 형식 조정보다 훨씬 빠릅니다.

사용법 2: 초안함에 원클릭 발행

자주 글을 발행한다면 WeChat API를 설정하여 플러그인이 브라우저를 열지 않고도 초안함에 직접 글을 푸시하도록 할 수 있습니다.

1단계: WeChat 계정 설정

상단의 계정 설정을 클릭하여 설정 팝업을 엽니다. 팝업 상단에는 추가된 모든 계정이 탭으로 표시되며, 클릭하여 전환할 수 있습니다.

입력해야 할 필드:

하단에는 수동으로 계정 추가 (양식 작성)와 새 계정 빠른 붙여넣기 (복사한 WeChat 플랫폼 내용에서 원클릭 자동 인식) 두 개의 버튼이 있습니다. 작성 후 저장을 클릭합니다.

새 계정 빠른 붙여넣기

양식을 작성하기 싫다면 더 빠른 방법이 있습니다. WeChat 공식 계정 플랫폼의 ‘기본 정보’ 페이지를 열고 내용을 모두 선택하여 복사한 후, WeChat Publisher 계정 설정 팝업에서 ‘새 계정 빠른 붙여넣기’를 클릭하고 내용을 붙여넣으면 플러그인이 계정 이름, AppID, AppSecret을 자동으로 인식하여 원클릭으로 추가합니다.

붙여넣는 내용 형식은 대략 다음과 같으며, 플러그인이 자동으로 파싱합니다:

Official Account
Your WeChat Account Name
AppID
wxb3f8a2e9c7d10456
AppSecret
e4a27f3c1b9d8056f2e8a3c7b4d90561

AppID 및 AppSecret 얻는 방법

1단계: developers.weixin.qq.com을 열고 ‘콘솔로 이동’을 클릭합니다.

2단계: ‘내 비즈니스’에서 WeChat 계정을 찾아 클릭합니다.

3단계: WeChat 계정 관리 백엔드에 들어가 ‘기본 정보’ 페이지에서 AppID를 찾아 (직접 복사) AppSecret 옆의 활성화를 클릭하고 QR 코드를 스캔하여 인증하면 획득할 수 있습니다.

AppSecret은 활성화하는 순간에만 전체가 한 번 표시됩니다. 즉시 복사하여 저장하세요. 그렇지 않으면 다시 생성해야 합니다.

IP 화이트리스트 설정

WeChat API는 인터페이스를 호출하는 머신의 IP 주소가 화이트리스트에 등록되어 있어야 합니다. WeChat Publisher는 사용자 컴퓨터에서 직접 API를 호출하므로, 사용자의 공인 IP를 화이트리스트에 추가해야 합니다.

플러그인에 도우미 기능이 있습니다. 계정 설정 팝업에서 ‘로컬 IP 감지’를 클릭하면 공인 IP를 자동으로 가져옵니다. ‘복사’를 클릭한 후 WeChat 플랫폼의 ‘API IP 화이트리스트’로 이동하여 붙여넣고 저장합니다.

집과 직장에서 모두 사용한다면 두 네트워크의 공인 IP가 다르므로 둘 다 추가하세요.

2단계: 초안 원클릭 발행

발행하려는 노트를 열고, 발행 정보 영역에 제목과 작성자를 입력하고 필요에 따라 커버를 설정한 후 상단의 초안 발행을 클릭합니다.

플러그인이 자동으로:

1. 글의 로컬 이미지를 WeChat CDN에 업로드
2. Mermaid 다이어그램과 수학 공식을 이미지로 렌더링
3. 렌더링된 HTML을 제목, 작성자, 커버와 함께 초안함에 제출

완료 후 WeChat 백엔드 초안함으로 가서 확인하고, 문제가 없으면 보내기를 진행합니다.

초안이 직접 발송되지는 않습니다. 백엔드에서 수동으로 보내야 합니다.

재발행 시 자동 업데이트, 중복 글 없음: 이 노트가 이전에 초안으로 발행된 적이 있다면, 수정 후 다시 ‘초안 발행’을 클릭하면 플러그인이 WeChat 플랫폼에서 기존 초안을 자동으로 찾아 업데이트하며, 새로운 중복 글을 생성하지 않습니다.

커버 설정 방법

발행 정보 영역에는 세 개의 커버 버튼이 있습니다:

커버 우선순위: 수동 선택 > 계정 기본 커버 > 자리 표시자 이미지.

계정 설정에 기본 커버를 설정해 두면 매번 발행할 때마다 수동으로 선택할 필요가 없어 편리합니다.

지원 형식

글 내용이 복잡할수록 절약되는 시간이 많아집니다. 코드 블록, 수학 공식, Mermaid 다이어그램이 포함된 글이라면 수동 처리 시간이 상당히 늘어납니다.

요약

오늘 배운 내용:

1. Obsidian에서 WeChat용 글을 쓸 때 가장 큰 문제는 형식 변환입니다. WeChat Publisher가 이 문제를 해결합니다.
2. 두 가지 사용 방법: HTML을 복사하여 WeChat 백엔드에 붙여넣기 (설정 불필요, 10초) 또는 API를 설정하여 초안함에 원클릭 발행 (더욱 편리)
3. API 설정에는 AppID + AppSecret + IP 화이트리스트가 필요하며, 한 번만 설정하면 됩니다.
4. 코드 블록 강조, Mermaid, 수학 공식, 로컬 이미지 자동 업로드 등 복잡한 형식을 지원합니다.
5. v0.1.13부터 개인 사용자에게 완전 무료, 모든 기능을 바로 사용할 수 있으며 활성화 코드가 필요 없습니다.

핵심 사항:

1. 개인 사용자에게 완전 무료이므로 부담 없이 다운로드하여 사용하세요.
2. 상업적 사용(기업, 교육, 재배포)의 경우 WeChat 계정 ‘HelloRanceLee’로 저자에게 연락하세요.
3. WeChat API 설정은 한 번만 하면 되며, 튜토리얼을 따라 하면 어렵지 않습니다.
4. 발행 전에 IP 화이트리스트를 설정해야 합니다. 그렇지 않으면 API 호출 시 오류가 발생합니다.
5. 처음에 스타일을 설정하고 저장한 후, 각 글마다 바로 적용하는 것을 권장합니다.

최신 버전의 플러그인 받기:

• GitHub: https://github.com/RanceLee233/wechat-publisher
• 직접 다운로드: https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

파트 5: AI 협업: Obsidian을 AI 워크벤치로 만들기