들쭉날쭉한 마크다운 표(|) 정렬(CJK 폭)

대다수의 영미권 오픈소스 마크다운 정렬 도구는 텍스트의 길이를 단순히 자바스크립트의 `.length` 속성(글자 수)으로만 측정합니다. 하지만 고정폭 폰트(Monospace) 환경에서 알파벳 `A`와 한글 `가`는 화면에서 차지하는 가로 너비가 전혀 다릅니다.

알파벳, 숫자, 기본 특수문자는 1칸 너비(반각, Half-width)를 차지하지만, 한글, 한자, 일본어 가나, 그리고 이모지(Emoji)는 정확히 2칸 너비(전각, Full-width)를 차지합니다.

예를 들어 영문 10글자(`HelloWorld`)와 한글 5글자(`안녕하세요`)는 `.length` 기준으로는 각각 10과 5이지만, 모노스페이스 화면에 출력되었을 때는 둘 다 정확히 10컬럼 너비를 차지합니다. 이를 고려하지 않는 일반 도구로 표를 정렬하면 한글이 들어간 행만 파이프가 오른쪽으로 툭 튀어나오거나 안쪽으로 찌그러지는 대참사가 일어납니다.

MarkdownHub는 동아시아 유니코드 표준 규격(East Asian Width)을 완벽히 적용하여 각 글자의 실제 터미널 표시 너비를 연산하므로, 한글과 영문, 이모지가 뒤섞인 복잡한 표에서도 파이프가 한 치의 오차도 없이 수직 칼각으로 정렬됩니다.

[들쭉날쭉한 원본 AI 생성 표]
| 항목 | 가격 | 설명 |
|---|---|---|
| 키보드 | 120,000원 | 기계식 청축 모델입니다 |
| Ram | 80,000원 | DDR5 16GB |
| USB | 5,000원 | 64GB |

[MarkdownHub CJK 2폭 정밀 계산 정렬 결과]
| 항목   | 가격      | 설명                   |
|:-------|:----------|:-----------------------|
| 키보드 | 120,000원 | 기계식 청축 모델입니다 |
| Ram    | 80,000원  | DDR5 16GB              |
| USB    | 5,000원   | 64GB                   |

마크다운 표의 두 번째 줄(구분선 행)은 각 열의 텍스트 정렬 방향을 지정하는 중요한 역할을 합니다.

MarkdownHub 정렬기는 원본의 정렬 방향을 그대로 보존하는 옵션 외에도, 모든 열을 좌측 정렬(`:---`), 가운데 정렬(`:---:`), 우측 정렬(`---:`)로 일괄 통일하는 맞춤형 오버라이드 옵션을 제공합니다.

또한 파이프와 텍스트 사이에 일정한 1칸 공백(Padding)을 엄격히 유지하여, GitHub나 GitLab 웹 뷰어뿐 아니라 VS Code 터미널에서 `git diff`를 비교할 때도 코드 리뷰어가 변경 사항을 한눈에 파악할 수 있도록 돕습니다.

💡 실무 노하우 팁

• GitHub 오픈소스 프로젝트에 기여(PR)할 때는 표를 수직 정렬해 두면 이후 행이 추가되거나 수정될 때 커밋 디프(Git Diff)가 훨씬 깨끗하게 남아 머지 승인율이 높아집니다.
• 문서에 이모지(🚀, 💡)가 포함된 경우 일부 터미널 폰트에 따라 1.5폭으로 표시될 수 있으므로, 핵심 데이터 열에는 이모지 사용을 자제하고 헤더에만 사용하는 것을 권장합니다.

Swagger나 Postman에서 추출한 방대한 API 파라미터 표는 수백 줄에 달하는 경우가 많습니다. 이를 손으로 정렬하는 것은 불가능에 가깝습니다.

MarkdownHub 정렬기는 브라우저 메인 스레드를 차단하지 않는 최적화된 스트링 버퍼 연산 알고리즘을 사용하여 수백 줄의 대형 표도 키보드 입력과 동시에 실시간 0.05초 만에 칼각으로 다듬어 냅니다.

특히 수십 명의 개발자가 함께 작업하는 오픈소스 리포지토리나 기업 내 모노레포(Monorepo) 프로젝트의 경우, 표 서식이 정리되지 않은 상태로 커밋되면 단 한 글자의 수정에도 불구하고 앞뒤 파이프 라인이 뒤흔들려 수십 줄의 불필요한 변경 내역(Diff Noise)이 깃 히스토리에 누적됩니다.

MarkdownHub를 통해 사전에 완벽히 너비를 통일한 표준 표 코드를 커밋하면 변경된 행만 정확하게 Git Diff 녹색/적색 하이라이트로 잡혀 코드 리뷰어의 피로도를 획기적으로 줄이고 PR 머지 속도를 대폭 단축시킵니다.

💡 실무 노하우 팁

• 사내 개발 위키나 README.md를 업데이트하기 전 MarkdownHub 칼각 정렬기를 프리커밋(Pre-commit) 검증 루틴처럼 활용하는 것을 적극 권장합니다.

표의 한 셀에 너무 긴 설명 문장이 들어가면 아무리 칼각으로 정렬하더라도 터미널이나 에디터 화면 가로폭을 넘어서서 가독성이 크게 저하됩니다.

이런 경우 텍스트를 핵심 요약형 키워드로 단축하거나, 줄바꿈이 불가피할 때는 공백 대신 `<br>` 태그를 사용하여 셀 내부 단락을 분리하는 것이 이상적입니다.

또한 모든 열의 너비를 균등하게 맞추기보다는, 성격에 따라 [ID/번호] 열은 최소 폭(3~5글자), [이름/상태] 열은 중간 폭(8~12글자), [상세 설명] 열은 가변 폭으로 배치하면 원본 마크다운 코드 상태에서도 시각적 리듬감이 살아납니다.

열 머리글(Header)의 경우 축약어(예: Qty, Ref, Desc)를 적절히 활용하고 두 번째 구분선의 정렬 표기(`:---:`)를 직관적으로 일치시켜 두면 향후 공동 작업자가 깃허브에서 웹 에디터로 수정할 때도 표 구조가 망가지지 않고 유지됩니다.

💡 실무 노하우 팁

• 정렬된 표 코드를 VS Code나 GitHub 에디터에 붙여넣을 때는 고정폭 글꼴(Fira Code, JetBrains Mono, D2Coding)을 사용해야 완벽한 수직 일직선 라인을 온전히 감상하실 수 있습니다.
• 표 앞뒤에 반드시 빈 줄(Empty line) 하나씩을 배치해야 마크다운 파서가 전후 일반 문단과 표를 안전하게 분리하여 인식합니다.