Slack의 Claude 출력물 서식 깨짐 문제를 해결하는 Claude Code 스킬 개발

실용적 조언

Slack에 복잡한 표나 체크리스트를 포함한 Claude 응답을 올리고 싶다면 slack-message-formatter 스킬을 사용하여 HTML로 변환 후 복사한다.
웹훅이나 API로 메시지를 보낼 때는 HTML 대신 도구에서 제공하는 mrkdwn 변환 기능을 활용한다.

섹션별 상세

Slack의 Markdown 처리 한계를 극복하기 위해 Claude Code 전용 스킬인 slack-message-formatter가 개발됐다. Claude가 생성한 Markdown을 서식 있는 HTML로 변환한 후 브라우저에서 수동 복사하여 Slack에 붙여넣는 방식을 사용한다. 이 과정을 통해 Slack의 기본 mrkdwn이 지원하지 않는 표, 중첩 리스트, 체크리스트 등의 서식을 완벽하게 보존했다. 기존 변환 도구들이 13가지 이상의 케이스에서 실패했던 문제를 해결하여 데이터 무결성을 확보했다.

bash

claude plugin marketplace add karanb192/slack-message-formatter
claude plugin install slack-message-formatter@slack-message-formatter

Claude Code 환경에서 해당 스킬을 설치하기 위한 터미널 명령어이다.

Claude Code 스킬을 사용하여 Slack 메시지 서식을 변환하고 붙여넣는 과정을 보여주는 시연 GIF이다. — ScreenshotClaude가 생성한 Markdown이 브라우저를 거쳐 Slack으로 복사될 때 표와 체크리스트 서식이 완벽하게 유지되는 실재 사례를 증명한다. 프로그래밍 방식의 API 대신 수동 복사 방식을 택했을 때의 결과물을 시각적으로 확인시켜 준다.

개발 과정에서 Slack의 메시지 입력창이 브라우저 클립보드의 서식 있는 HTML을 수용한다는 사실이 확인됐다. 일반적인 프로그래밍 방식의 클립보드 API를 사용하면 서식이 깨지지만, 사용자가 직접 Cmd+C로 복사할 때는 복잡한 구조가 유지된다. 이에 따라 도구는 변환된 결과를 브라우저 페이지로 띄워 사용자의 수동 복사를 유도하는 워크플로우를 채택했다. 이는 API나 웹훅을 통한 전송 시 발생하는 서식 제한을 우회하는 실질적인 해결책이 됐다.

용어 해설

슬랙 마크다운(mrkdwn): — Slack 고유의 텍스트 서식 지정 언어로, 표준 Markdown과 달리 표(Table)나 체크리스트 등의 복잡한 레이아웃을 지원하지 않는다. 이로 인해 LLM이 생성한 구조화된 데이터를 Slack에 공유할 때 정보가 누락되거나 가독성이 떨어지는 문제가 발생하며, 이를 해결하기 위한 변환 과정이 필수적이다.
서식 있는 HTML(Rich HTML): — 단순 텍스트를 넘어 글꼴 스타일, 표, 리스트 등의 구조적 정보를 포함하는 HTML 형식이다. 클립보드를 통해 서로 다른 애플리케이션 간에 서식을 유지하며 데이터를 전달할 때 사용된다. 본 아티클에서는 브라우저에 렌더링된 HTML을 복사하여 Slack의 서식 제한을 우회하는 핵심 매개체로 활용된다.
코딩 에이전트(Coding Agent): — 사용자의 자연어 명령을 이해하고 코드를 작성, 실행, 수정하는 자율형 AI 도구이다. Anthropic의 Claude Code가 대표적인 사례이며, 터미널 환경에서 개발자와 협업하며 복잡한 리팩터링이나 도구 통합 작업을 수행한다. 본문에서는 이러한 에이전트의 기능을 확장하는 스킬(Skill) 개발 사례로 언급된다.

언급된 도구

slack-message-formatter추천링크

Claude Code의 Markdown 출력을 Slack용 HTML 및 mrkdwn으로 변환

언급된 리소스

GitHubslack-message-formatter GitHub Repository