README·위키에 표 넣기
스프레드시트로 정리한 API 목록이나 설정 값 표를 GitHub README, 사내 위키에 그대로 옮깁니다.
MARKDOWN TABLE · FROM EXCEL
Markdown 표 만들기
엑셀 표를 README 에 옮기려면?
엑셀에서 이름·점수 두 열을 복사해 붙여 넣으면 | 와 --- 로 된 Markdown 표가 바로 만들어집니다. 이미 있는 Markdown 표를 TSV 로 되돌려 다시 엑셀에 붙일 수도 있습니다.
- TSV·CSV 입력
- 표→TSV 역변환
- 브라우저에서만 처리
- 무료 · 가입 없음
결과
이 도구를 쓰는 법
첫 행을 머리글로 사용합니다. CSV에서는 큰따옴표로 감싼 쉼표와 줄바꿈, 이중 큰따옴표를 처리합니다. Markdown에서 의미가 있는 |와 줄바꿈은 자동으로 이스케이프합니다.
Markdown → TSV는 일반적인 파이프 표와 정렬 구분 행을 읽습니다. 셀 안의 이스케이프된 파이프도 보존합니다.
브라우저에서만 처리되며 입력값을 서버로 보내지 않습니다.
MADE FOR YOUR WORK
이럴 때 쓰세요
PR 설명에 비교표 달기
성능 측정 결과나 변경 전후 값을 엑셀에서 복사해 PR 본문에 읽기 좋은 표로 붙입니다.
문서 표를 다시 엑셀로
Markdown 문서에 있던 표를 TSV 로 되돌려 엑셀에 붙여 넣고 정렬·계산을 이어 갑니다.
CSV 내보내기 정리
DB 나 관리 화면에서 받은 CSV 를 붙여 넣어 따옴표·쉼표가 섞인 값도 깨지지 않은 표로 만듭니다.
STEP BY STEP
Markdown 표 만들기 사용 방법
이렇게 쓰세요
데이터 붙여 넣기
엑셀 범위를 복사해 입력 칸에 붙여 넣습니다. 첫 줄이 표의 머리글이 됩니다.
입력 형식·정렬 고르기
입력 형식에서 TSV 또는 CSV 를, 정렬에서 왼쪽·가운데·오른쪽을 고릅니다. 정렬은 모든 열에 똑같이 적용됩니다.
Markdown으로 누르기
컬럼 폭 맞춤을 켜 두면 원본에서도 열이 줄 맞춰 보이도록 공백을 채웁니다. 결과 칸의 복사 버튼으로 가져갑니다.
되돌릴 때는 Markdown → TSV
Markdown 표를 입력 칸에 넣고 누르면 구분 행을 빼고 탭으로 구분한 TSV 를 돌려줍니다.
UNDERSTAND THE BASICS
Markdown 표 문법, 세 가지만 알면 된다
Markdown 표는 GitHub 식(GFM) 확장 문법입니다. 첫 줄은 머리글, 둘째 줄은 하이픈으로 된 구분 행, 셋째 줄부터가 데이터이고, 칸은 세로줄 | 로 나눕니다. 구분 행이 없으면 표로 인식되지 않고 그냥 문장으로 보입니다.
열 정렬은 구분 행의 콜론 위치로 정합니다. 왼쪽에 콜론을 붙이면 왼쪽 정렬, 양쪽이면 가운데, 오른쪽이면 오른쪽 정렬입니다. 숫자 열은 오른쪽 정렬로 두면 자릿수가 맞아 비교하기 쉽습니다.
칸 안에 세로줄을 그대로 쓰면 칸이 하나 더 생깁니다. 그래서 내용 속 | 는 \| 로, 줄바꿈은 <br> 로 바꿔 적어야 합니다. 이 도구는 이 두 가지와 역슬래시를 자동으로 처리합니다. 원본에서 줄을 맞춘 공백은 보기 좋으라는 것일 뿐, 렌더링 결과에는 영향이 없습니다.
| 구분 행 칸 | 의미 |
|---|---|
| :--- | 왼쪽 정렬 |
| :---: | 가운데 정렬 |
| ---: | 오른쪽 정렬 |
| --- | 정렬 지정 없음(대부분 왼쪽으로 보임) |
| \| | 칸 안에 쓰는 세로줄 문자 |
| <br> | 칸 안의 줄바꿈 |
Markdown 표 만들기 사용 안내
TSV 또는 CSV를 정렬 가능한 Markdown 표로 변환하고 Markdown 표를 TSV로 되돌립니다.
엑셀이나 스프레드시트의 셀 범위를 복사해 붙여 넣으세요. 입력 형식, 정렬, 컬럼 폭 맞춤을 확인한 뒤 생성된 Markdown 표를 복사하세요.
QUICK EXAMPLE
Markdown 표 만들기 사용 예제
입력 · 시작
이름 점수 민수 90
결과 · 확인
탭으로 구분한 두 열을 Markdown 표로 변환
셀 안의 세로줄은 표 구분자와 충돌할 수 있으므로 결과를 미리 확인하세요.
어떻게 구현했나
표 만들기와 되돌리기가 서로 대칭입니다. 만들 때는 각 열에서 가장 긴 칸을 재서 폭을 맞추고(최소 3칸), 고른 정렬에 따라 구분 행의 콜론 위치를 정합니다. 폭 맞춤은 보기 좋으라고 넣은 것이지 Markdown 문법이 요구하는 것은 아닙니다.
되돌릴 때는 두 번째 줄이 정렬 구분 행인지부터 확인합니다. 그게 아니면 Markdown 표가 아니므로 변환하지 않고 오류를 냅니다. 표처럼 생긴 아무 텍스트나 받아 이상한 결과를 내놓는 것보다 낫습니다.
칸을 자를 때 파이프(|)를 그냥 나누면 안 됩니다. 백슬래시로 이스케이프한 \| 는 칸 구분이 아니라 내용이기 때문에, 한 글자씩 읽으며 이스케이프 상태를 추적합니다. 칸 안의 <br> 은 되돌릴 때 줄바꿈으로 복원합니다.
BEFORE YOU FINISH
자주 하는 실수
셀 안 줄바꿈이 있는 범위를 복사한다
TSV 모드는 탭과 줄바꿈으로만 칸을 나눕니다. 엑셀 셀 안에 줄바꿈이 있으면 행이 쪼개지니, 줄바꿈을 지우고 복사하거나 CSV 로 저장해 CSV 모드로 넣으세요.
구분 행 없이 손으로 표를 쓴다
머리글 다음 줄에 --- 구분 행이 없으면 Markdown 표가 아닙니다. Markdown → TSV 도 둘째 줄이 구분 행이 아니면 오류를 냅니다.
한글 표가 어긋나 보인다고 고친다
폭 맞춤은 글자 수 기준이라 한글처럼 넓은 글자가 섞이면 편집기에서 세로줄이 들쭉날쭉해 보입니다. 렌더링된 표는 정상이니 손으로 공백을 맞출 필요는 없습니다.
자주 묻는 질문
엑셀 표를 마크다운 표로 바꾸는 방법은?
엑셀에서 범위를 복사해 입력 칸에 붙여 넣고 입력 형식을 TSV 로 둔 채 'Markdown으로'를 누르면 됩니다. 엑셀 복사 데이터는 탭으로 구분돼 있습니다.
열마다 정렬을 다르게 할 수 있나요?
이 도구의 정렬 옵션은 모든 열에 같게 적용됩니다. 특정 열만 바꾸려면 결과의 둘째 줄에서 그 칸의 콜론 위치만 고쳐 주세요.
열 개수가 행마다 다르면 어떻게 되나요?
가장 긴 행에 맞춰 모자란 칸을 빈칸으로 채웁니다. 첫 줄은 항상 머리글로 쓰이니 머리글 행이 빠지지 않았는지 확인하세요.
CSV 에 쉼표나 따옴표가 든 값도 되나요?
됩니다. 큰따옴표로 감싼 칸 안의 쉼표와 줄바꿈, 두 번 쓴 큰따옴표("")를 값으로 읽습니다. 따옴표가 닫히지 않으면 오류로 알려 줍니다.
GitHub README 에서 마크다운 표가 안 보여요
둘째 줄 구분 행이 빠졌거나, 머리글과 구분 행의 칸 수가 다르면 표로 인식되지 않습니다. 이 도구가 만든 표는 GFM 형식이라 GitHub, GitLab 에서 그대로 렌더링됩니다.
입력한 데이터는 어디에서 처리하나요?
이 도구의 입력 데이터는 브라우저에서 처리하며 도구 기능을 위해 서버로 업로드하지 않습니다. 결과를 공유하기 전 민감한 정보가 없는지 확인하세요.