바오위 마크다운 포맷터
평문이나 거친 마크다운을 원문 그대로 유지하면서 제목·요약·소제목·목록·표로 읽기 좋게 정리해 주는 스킬입니다.
콘텐츠·글쓰기입문★ 24,749⑂ 2,764AI 점수 8/10마지막 업데이트: 2026. 7. 4.
무엇을 해주나
- 파일을 읽어 평문인지 마크다운인지 자동 판별하고, 이미 마크다운이면 "전체 최적화 / 기존 구조 유지 / 타이포그래피만" 중에서 선택하게 합니다.
- 독자 관점에서 핵심 주장·인상적인 문장·구조 문제를 정리한 분석 파일(
{파일명}-analysis.md) 을 먼저 만듭니다. - YAML 프론트매터의
title,slug,summary,description,coverImage를 채우고, 제목은 후크 공식 기반 후보 4~5개를 제시해 고르게 합니다. - 소제목·굵게·목록·표·인용문·코드 표기를 적용하되 문장을 추가·삭제·재작성하지 않는다는 원칙을 지킵니다.
- 마지막으로
scripts/main.ts를 실행해 한중일-영문 사이 공백, 강조 표시 오류, 전각 따옴표 등 타이포그래피를 자동 교정하고 변경 내역 리포트를 출력합니다.
이런 분께 추천
- 블로그·뉴스레터·기술 문서를 자주 쓰면서 매번 서식 정리에 시간을 쓰는 분
- 회의록이나 음성 전사본처럼 줄글로 쏟아진 텍스트를 문서화해야 하는 분
- 한국어·중국어·일본어와 영어가 섞인 글의 공백·문장부호를 일관되게 맞추고 싶은 분
- 프론트매터 메타데이터(제목, 요약)를 정적 사이트 규격에 맞춰 자동 생성하고 싶은 분
활용 예시
- 음성 전사본 정리: "draft.txt를 마크다운으로 포맷해줘" → 분석 파일 생성 후 소제목·목록이 붙은
draft-formatted.md가 만들어집니다. - 블로그 발행 준비: 이미 작성한
post.md에서 제목 후보 5개를 받아 고르고,summary/description이 채워진 프론트매터를 얻습니다. - 타이포그래피만 손보기: 서식은 만족스럽지만 한글·영문 사이 공백만 맞추고 싶을 때 3번 옵션을 골라 원본 파일을 그대로 교정합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 JimLiu/baoyu-skills 의 skills/baoyu-format-markdown 폴더를 내 ~/.claude/skills/baoyu-format-markdown/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/JimLiu/baoyu-skills.git && mkdir -p ~/.claude/skills && cp -r baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 홈 디렉터리로 이동합니다:
cd ~ - 저장소를 내려받습니다:
git clone https://github.com/JimLiu/baoyu-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 이 스킬만 복사합니다:
cp -r baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/ - 타이포그래피 스크립트 실행 환경을 준비합니다.
bun --version이 동작하지 않으면curl -fsSL https://bun.sh/install | bash로 bun을 설치하거나, Node.js가 있다면npx -y bun이 사용됩니다. - Claude Code를 다시 실행한 뒤 "이 파일 마크다운으로 포맷해줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
- (선택) 제목·요약 선택 질문을 건너뛰려면
~/.baoyu-skills/baoyu-format-markdown/EXTEND.md를 만들고auto_select: true를 적어 둡니다.
GitHub에서 원본 보기 ↗라이선스: MIT