작업 방식
Baoyu Markdown to HTML은 기사를 인라인 CSS가 적용된 HTML로 변환하며 WeChat Official Account 워크플로에 최적화되어 있습니다. 테마와 타이포그래피 선택뿐 아니라 코드 강조, 각주, 알림 블록, 다이어그램을 지원합니다. 변환한 HTML은 Markdown 원본 옆에 저장하고, 기존 HTML 출력이 있으면 타임스탬프가 포함된 백업을 만듭니다.
이 스킬은 완성된 기사에 영향을 주는 발행 세부 사항도 처리합니다. keep-title을 활성화하지 않으면 첫 제목은 기본적으로 제거되며, 외부 링크는 명시적으로 요청할 때만 글 하단의 인용으로 바뀝니다. Mermaid 다이어그램은 브라우저에서 PNG 이미지로 렌더링해 캐시하며, 렌더링할 수 없으면 텍스트로 대체합니다.
예상 산출물
- 선택한 테마와 인라인 CSS가 적용된 HTML 파일.
- 렌더링에 성공한 Mermaid PNG를 포함한 생성 또는 참조 이미지 정보.
- HTML 경로와, 백업이 있을 경우 백업 경로를 담은 구조화된 결과.
브리프에서 검토까지
- 01기사 표현 방식 정하기
명시적인 테마 선택과 EXTEND.md 설정을 읽습니다. 입력에 CJK 문자가 있고 baoyu-format-markdown을 사용할 수 있다면, 변환 전에 별도의 서식 정리 단계를 제안합니다.
- 02인용과 제목 처리 선택
요청이 없으면 외부 링크 인용은 꺼 둡니다. 첫 제목을 기사 본문에 남길지 결정합니다.
- 03콘텐츠와 다이어그램 변환
선택한 표현 옵션으로 포함된 main.ts 변환기를 Bun 또는 문서화된 npx 대체 방법으로 실행합니다. 가능하면 Mermaid는 브라우저 기반 PNG 렌더링과 캐시를 사용합니다.
- 04발행용 결과 확인
HTML을 열고 다이어그램을 확인한 뒤 결과 경로를 보고합니다. 정상 생성된 이미지와 대체 출력된 Mermaid 마크업을 구분합니다.