HUB - Updated 2026-05-14
Markdown / GitHub Docs Center
CSV/TSV를 Markdown 표로 바꾸고 GitHub README, 문서 표, 링크, 변경 로그를 깔끔하게 관리하는 허브.
Open Markdown Table GeneratorCSV나 TSV 데이터를 README에 넣어야 한다면 손으로 표를 맞추기보다 Markdown 표로 변환한 뒤 열 개수와 구분자를 확인하는 편이 빠릅니다. GitHub 문서는 표, 링크, 코드 블록이 조금만 틀어져도 읽기 어려워집니다. 반복되는 문서 작업은 변환 도구와 간단한 작성 규칙을 함께 쓰면 협업 비용을 줄일 수 있습니다.
이 주제가 중요한 이유
README, 릴리즈 노트, API 문서, 비교표는 개발팀과 운영팀이 함께 보는 기준 문서가 됩니다. 표가 깨지거나 열 정렬이 맞지 않으면 내용이 맞아도 신뢰도가 떨어지고, 리뷰 시간이 길어집니다.
Markdown은 간단하지만 환경마다 지원 범위가 조금씩 다릅니다. 특히 GitHub README에서 잘 보이는 표를 만들려면 구분자, 헤더, 파이프 문자 이스케이프를 신경 써야 합니다.
가장 흔한 문제
| 문제 | 흔한 원인 | 먼저 확인할 것 |
|---|---|---|
| Markdown 표가 깨짐 | 헤더와 구분선 열 개수 불일치 | 첫 두 줄의 열 개수 |
| CSV가 한 셀로 들어감 | 구분자 감지 실패 | 쉼표/탭 여부 |
| 파이프 문자가 열을 나눔 | 셀 내부 ` | ` 미이스케이프 |
| README 표가 너무 넓음 | 열이 많거나 설명이 김 | 열 분리 또는 요약 |
| 복사 후 줄바꿈 깨짐 | 원본 줄바꿈/따옴표 처리 문제 | CSV 원본 구조 |
바로 쓰는 도구
Markdown Table Generator는 CSV 또는 TSV를 GitHub README에 붙여넣기 좋은 Markdown 표로 변환합니다. 변환 후에는 행 수, 열 수, 구분자를 확인하고 바로 복사할 수 있습니다.
데이터가 큰 경우에는 전체 표를 README에 넣기보다 핵심 열만 남기거나 별도 파일로 분리하는 편이 좋습니다.
에러별 해결 문서
기초 가이드
심화 칼럼 예정
- README와 Markdown 문서가 협업 비용을 줄이는 방식
- 기술 문서에서 표를 남발하지 않는 기준
- AI가 인용하기 쉬운 Markdown 문서 구조
관련 용어
- Markdown table: 파이프 문자와 구분선으로 만드는 표
- README: 저장소의 목적과 사용법을 설명하는 기본 문서
- TSV: 탭으로 열을 구분한 텍스트 데이터
- Escape: 특수문자가 문법으로 해석되지 않도록 처리하는 방식
- Changelog: 변경 사항을 시간 순서로 정리한 문서
업데이트 날짜
2026-05-14