마크다운 표 정리기

마크다운 표의 열 너비를 맞추고 구분선을 다시 만듭니다. README, 이슈 댓글, 변경 로그에 붙여 넣기 좋은 읽기 쉬운 소스 표가 목표입니다. 렌더러가 아니라 텍스트 정렬기입니다.

동작 요약

1. 줄을 읽어 셀로 나눕니다(\| 이스케이프 지원).
2. 두 번째 행이 구분선이면 정렬 정보를 읽고, 아니면 기본 왼쪽 정렬 구분선을 삽입합니다.
3. 각 열의 최대 글자 수에 맞춰 셀을 패딩합니다.
4. 헤더·구분선·본문을 다시 조립합니다.

헤더+데이터만 넣은 입력도 최소 한 개의 데이터 행이 필요합니다. 행이 부족하면 안내 메시지가 표시됩니다.

정렬 예

구분 셀 | ---: | :---: | :--- | 는 각각 오른쪽·가운데·왼쪽입니다. 폭은 열 내용과 최소 구분선 길이를 함께 반영합니다. 이모지·전각 문자는 표시 폭과 String.length가 다를 수 있어, 드문 깨짐은 수동으로 한 칸 조정하세요.

한계

다중 줄 셀, HTML 중첩 표, 복잡한 인라인 HTML은 지원 대상이 아닙니다. CSV를 표로 만들고 싶다면 먼저 CSV → JSON으로 구조를 확인한 뒤 표를 작성하는 편이 안전합니다. 공백 정리만 필요하면 Builder가 남긴 다른 텍스트 도구 대신 이 포매터의 패딩에 맡기세요.

워크드 예: 정렬 전과 후

정렬 전(열이 들쭉날쭉):

| 도구 | 용도 | 상태 |
| --- | --- | --- |
| JSON 포매터 | 데이터 | 사용 가능 |
| 로마자 | 글쓰기 | 사용 가능 |

포매터는 각 열의 가장 긴 셀에 맞춰 공백을 넣고 구분선을 다시 씁니다. 소스 보기에서도 열이 맞아서 리뷰 댓글이 줄어듭니다. 렌더된 HTML 표의 모양은 사이트의 CSS가 결정하므로, 이 도구는 소스 가독성에 초점을 둡니다.

README에 붙이기 전 체크

• 헤더 행 의미가 열 내용과 일치하는가
• 구분 행 정렬이 숫자 열(오른쪽)과 이름 열(왼쪽)에 맞는가
• 셀 안 |를 \|로 이스케이프했는가
• 빈 셀이 열 밀림을 일으키지 않는가(열 개수 통일)

CSV 원본이 있다면 표로 옮기기 전에 따옴표·인코딩을 CSV 변환기로 검증하세요. 표가 데이터 소스의 진실이 되어서는 안 되고, 문서용 스냅샷이어야 합니다.

유니코드 폭

한글·이모지는 단말 폰트에 따라 표시 폭이 달라 length 기준 패딩과 화면이 어긋날 수 있습니다. 깨지면 해당 열만 수동으로 스페이스를 조정하거나, 이모지를 본문 밖으로 빼세요. 이 동작은 단순한 코드 포인트 길이 기준이며 East Asian Width 전체 규칙을 구현하지는 않습니다.

이슈·PR 템플릿에 표를 넣을 때

GitHub·GitLab 댓글은 고정폭으로 소스를 보여 주지 않을 때가 많아, 정렬되지 않은 표는 편집 시에만 고통스럽습니다. 포매터로 맞춘 뒤 붙여 넣으면 이후 수정자가 열을 찾기 쉽습니다. 숫자 열은 오른쪽 정렬(---:)로 두면 소스에서도 자릿수가 맞춰집니다.

표가 곧 데이터가 되어서는 안 됩니다. 원본이 CSV라면 CSV를 진실 공급원으로 두고, 표는 요약본만 문서에 남기세요. 열을 추가·삭제할 때는 포매터를 다시 돌려 구분선 길이를 맞춥니다.

셀에 백슬래시와 파이프를 써야 할 때는 본문에서 백슬래시+파이프로 이스케이프한다고 기억하면 됩니다. 프론트매터 FAQ에도 같은 규칙을 적어 두었습니다.