마크다운 표가 자꾸 깨질 때 HTML 표로 바꿔야 할까?

무엇을 해결하나

GitHub, Notion, 블로그처럼 렌더러가 다른 환경에서 표가 깨질 때 마크다운을 유지할지 HTML로 전환할지 결정할 때 사용합니다.

준비할 정보

• 실제 적용할 환경과 대상 범위를 먼저 적습니다.
• 현재 상태와 기대 결과를 숫자나 예시로 준비합니다.
• 운영 데이터, 개인정보, secret은 제거하거나 안전한 placeholder로 바꿉니다.
• 변경 작업이라면 승인자, backup, rollback 가능 여부를 확인합니다.

복사해서 쓰는 템플릿

아래 표의 사용 환경을 검토하고 마크다운 유지안과 HTML 전환안을 비교해줘.
게시 위치: {{PLATFORM}}
편집자: {{EDITORS}}
모바일 비중: {{MOBILE_SHARE}}
접근성 요구: {{ACCESSIBILITY}}
현재 표: {{TABLE}}

비교 항목은 호환성, 유지보수, 모바일 가독성, 접근성으로 해줘.

실행 순서

1. placeholder를 실제 환경 정보로 바꾸되 secret 값은 입력하지 않습니다.
2. 먼저 조회와 미리보기로 대상 범위, 권한, 현재 상태를 확인합니다.
3. 결과가 예상과 맞을 때만 가장 작은 단위로 실행하거나 초안을 생성합니다.
4. 변경 전후의 수치와 화면을 같은 조건에서 비교해 기록합니다.
5. 이상이 있으면 작업을 넓히지 말고 중단 조건과 rollback 절차를 따릅니다.

결과 확인

실제 게시 환경의 미리보기와 모바일 폭에서 모두 확인하고, 키보드와 화면 읽기 도구로 헤더 관계가 전달되는지도 살펴봅니다.

검수 결과에는 확인한 사실, 아직 확인하지 못한 가정, 다음 행동을 분리해서 남깁니다. 다른 사람이 같은 입력으로 재현할 수 있도록 환경과 확인 시각도 함께 기록하면 좋습니다.

주의사항

HTML 허용 여부는 플랫폼마다 다릅니다. 보안 필터가 태그를 제거하는 환경에서는 표 대신 소제목과 목록으로 재구성하는 편이 안전합니다.

AI가 만든 설명과 명령은 초안입니다. 실제 제품 버전과 조직 정책, 공식 문서를 대조하고 영향이 있는 작업은 dev나 격리 환경에서 먼저 검증하세요.

판단 기준

이 질문에는 모든 상황에 맞는 한 가지 답이 없습니다. 독자의 목적, 운영 위험, 팀의 검수 역량, 변경을 되돌릴 수 있는지를 기준으로 선택합니다. 먼저 작은 범위에서 두 선택지를 비교하고 결과를 기록한 뒤 적용 범위를 넓히세요.