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