마크다운 표 CSV 변환기
왼쪽에 마크다운 문서나 CSV를 넣으면 오른쪽에 변환 결과가 바로 나옵니다. 위의 방향 탭에서 표 → CSV 또는 CSV → 표를 바꾸세요.
행과 열 미리보기
결과를 저장하기 전에 셀의 경계를 확인하세요.
표를 넣으면 첫 행과 이어지는 데이터가 여기에 보입니다.
바로 쓸 수 있게.
- 바로 보이는 화면입력 위치와 결과 위치를 또렷하게 둡니다.
- 결과 먼저핵심 결과를 앞에 두고, 과정은 필요할 때만 보여줍니다.
- 요구 줄이기가입이나 불필요한 정보 입력 없이 바로 쓰게 합니다.
문서 표와 CSV를 옮길 때 확인할 기준
마크다운 표 CSV 변환기는 문서에 적힌 파이프 표를 행과 열로 읽어 CSV 파일로 만들고, CSV 데이터는 다시 마크다운 표로 조립합니다. README, 회의록, 제품 목록처럼 표가 문장 사이에 들어 있어도 표를 찾아 선택할 수 있습니다. CSV는 쉼표로 셀을 구분하는 텍스트 형식으로, 스프레드시트에 가져가거나 데이터 교환에 사용할 수 있습니다.
이 도구가 읽는 표는 GitHub Flavored Markdown(GFM)의 파이프 표입니다. 표를 붙여 넣거나 UTF-8 텍스트 파일을 선택하면 브라우저 안에서 변환하며 입력을 서버에 보내거나 자동 저장하지 않습니다. 결과를 복사하기 전에 미리보기와 경고를 보면 열이 빠지거나 셀 안의 줄바꿈이 달라지는 상황을 확인할 수 있습니다.
마크다운 표는 무엇을 기준으로 읽나요?
첫 줄은 열 이름, 다음 줄은 하이픈으로 만든 구분선, 그 아래는 데이터 행입니다. 구분선의 콜론은 왼쪽·가운데·오른쪽 정렬을 나타낼 뿐 CSV 값이 아닙니다. 첫 줄과 구분선의 열 수가 다르면 유효한 GFM 표가 아니므로 변환 대상에서 제외합니다.
- `| 이름 | 지역 |` 다음에 `| --- | --- |`를 두면 두 열 표가 됩니다.
- 맨 앞과 맨 뒤의 파이프는 없어도 되지만 열 사이 파이프는 필요합니다.
- HTML 표, 병합 셀, 여러 줄로 된 마크다운 셀은 이 형식에 포함되지 않습니다.
문서에 표가 여러 개 있을 때
표만 따로 잘라 붙일 필요는 없습니다. 문서 전체를 넣으면 구분선이 있는 GFM 표를 찾아 목록으로 보여 줍니다. 그중 한 표를 선택하면 오른쪽 결과와 미리보기가 해당 표로 바뀝니다. 서로 다른 표를 하나의 CSV에 억지로 이어 붙이지 않으므로 제목이나 열 구성이 다른 표도 구분해서 저장할 수 있습니다.
- 회의 안건 표와 담당자 표가 함께 있으면 표 선택 메뉴에서 고릅니다.
- 코드 블록 안의 파이프 문자는 표로 취급하지 않습니다.
- 선택한 표의 행·열 수를 결과 옆에서 확인하세요.
셀 안의 파이프와 서식
셀 값에 실제 `|` 문자가 들어 있으면 마크다운에서는 `\|`로 써야 열 구분과 혼동되지 않습니다. 변환할 때 이 이스케이프를 실제 파이프 문자로 읽고, CSV를 표로 돌릴 때 다시 이스케이프합니다. 굵게 표시하는 `**` 같은 인라인 마크다운 문자는 데이터로 보존합니다. 화면에 렌더링된 서식 없는 글자로 바꾸는 도구는 아닙니다.
- `A\|B`는 한 셀의 `A|B`입니다.
- `**중요**`는 별표까지 담긴 원문 값으로 CSV에 들어갑니다.
- 셀 주변 공백은 GFM 표 규칙에 따라 정리하지만 CSV 필드 안 공백은 유지합니다.
CSV에서 쉼표와 큰따옴표는 어떻게 보존하나요?
CSV는 쉼표가 열 경계이지만 셀 값 자체에도 쉼표가 올 수 있습니다. `서울, 한국` 같은 셀은 큰따옴표로 감싸고, 셀 안의 큰따옴표는 두 번 써서 구별합니다. 이 도구는 인용된 줄바꿈도 한 셀의 내용으로 읽습니다. 결과 텍스트를 눈으로 볼 때 따옴표가 늘어 보이는 것은 데이터가 망가진 것이 아니라 CSV의 인용 규칙입니다.
- 셀 값 `서울, 한국` → CSV 필드 `"서울, 한국"`
- 셀 값 `그는 "네"라고 답함` → CSV 필드 `"그는 ""네""라고 답함"`
- 잘못 닫힌 CSV 따옴표는 추측해 고치지 않고 오류를 알립니다.
첫 줄이 열 이름이 아닌 CSV라면
마크다운 파이프 표에는 반드시 머리글 줄이 있어야 합니다. 기본값은 CSV 첫 행을 머리글로 사용하므로 `이름,지역` 다음 `민지,서울`을 넣으면 이름·지역이 표의 열 이름이 됩니다. 첫 행도 데이터라면 “첫 행을 머리글로 사용”을 끄세요. 도구가 `열 1`, `열 2`를 만들어 모든 원본 행을 본문에 남깁니다.
- 머리글이 있는 CSV: 첫 행을 머리글로 사용
- 머리글이 없는 CSV: 옵션을 끄고 자동 열 이름을 확인
- CSV 형식 자체에는 첫 행이 헤더인지 표시하는 보편적인 신호가 없습니다.
행마다 열 수가 다르면?
GFM 표에서는 본문 행이 짧으면 부족한 셀을 빈값으로 채우고, 길면 머리글보다 많은 셀을 표시하지 않습니다. CSV에서는 각 행의 열 개수가 다르면 스프레드시트에서 열이 어긋나기 쉽습니다. 이 도구는 GFM 규칙대로 처리하되 부족·초과 행을 경고해 원문을 고칠 기회를 줍니다. 특히 초과 셀은 결과에 남지 않으므로 저장 전에 원본을 확인하세요.
- 2열 표의 `| 민지 |`는 둘째 셀이 빈 CSV 행이 됩니다.
- 2열 표의 `| 민지 | 서울 | 메모 |`에서 메모는 제외되고 경고가 나옵니다.
- CSV를 표로 바꿀 때도 결과의 열 수와 미리보기를 확인하세요.
CSV 셀에 줄바꿈이 들어 있으면
큰따옴표로 감싼 CSV 필드는 줄바꿈을 포함할 수 있습니다. 하지만 GFM 파이프 표의 셀은 한 물리적 줄 안에 있어야 하므로 원래 개행을 그대로 표 셀에 넣을 수 없습니다. 이 도구는 CSV → 표에서 셀 안 줄바꿈을 `<br>`로 바꾸고 경고합니다. 원본의 정확한 개행 문자까지 되돌려야 하는 데이터라면 변환한 마크다운보다 원본 CSV를 보관하세요.
- CSV 입력의 인용된 개행은 파싱할 때 한 셀로 유지합니다.
- 마크다운 출력에는 읽기 쉬운 `<br>` 표기를 사용합니다.
- 변환 결과는 셀 값의 모든 바이트를 왕복 보존하는 형식이 아닙니다.
한글 CSV를 엑셀에서 열 때
CSV 다운로드는 UTF-8로 만듭니다. 파일을 바로 열었을 때 한글이 깨지는 환경을 위해 “UTF-8 표시 추가” 옵션을 기본으로 켭니다. 이 옵션은 파일 맨 앞의 BOM을 붙이는 방식이며 CSV 텍스트를 복사할 때는 붙지 않습니다. 다른 데이터 파이프라인에서 BOM이 데이터로 읽힌다면 옵션을 끄고 저장한 뒤 가져오기 화면에서 UTF-8을 선택하세요.
- 엑셀에서 바로 열기: UTF-8 표시를 켜고 저장해 보세요.
- 프로그램에서 CSV를 읽기: BOM 필요 여부를 확인하고 선택하세요.
- 문자 인코딩과 쉼표/따옴표 규칙은 서로 다른 문제입니다.
수식처럼 시작하는 값은 선택해 보호합니다
스프레드시트는 `=`, `+`, `-`, `@`로 시작하는 일부 셀을 수식으로 해석할 수 있습니다. “수식처럼 시작하는 셀 보호”를 켜면 의심스러운 값 앞에 탭을 넣고 해당 필드를 인용합니다. 변형된 셀 수를 화면에 알립니다. 순수한 부호 있는 숫자는 숫자로 두지만, 보호 방식은 파일을 여는 프로그램과 재저장 방식에 따라 다를 수 있어 모든 환경의 안전을 보장하지 않습니다.
- 신뢰하지 않는 문서에서 만든 CSV를 열기 전에는 이 옵션을 확인하세요.
- 보호를 켜면 일부 셀의 실제 텍스트가 바뀝니다. 원본 값 보존이 우선이면 끄세요.
- 수식을 실제로 실행하려는 데이터도 보호 대상이 될 수 있습니다.
파일 선택·복사·저장 전에 확인할 것
MD·Markdown·CSV·TXT 파일은 UTF-8 텍스트로 읽으며 파일당 1MiB까지만 선택합니다. 변환은 최대 1만 행·200열·빈 칸 보정 후 20만 셀까지 처리하므로 큰 표는 나누어 넣으세요. PDF, DOCX, HWP는 직접 해석하지 않으므로 문서에서 표 부분을 복사해 넣으세요. 오른쪽 결과를 복사하거나 CSV/MD 파일로 저장할 수 있지만 원본 파일을 덮어쓰지는 않습니다. 개인정보나 수식이 포함된 표를 다른 사람에게 보내기 전에는 결과 행과 열을 검토하세요.
- 표가 하나도 감지되지 않으면 머리글과 구분선 줄을 확인합니다.
- 경고가 있으면 미리보기와 원문 행을 대조합니다.
- 파일 형식·헤더·BOM·보호 옵션을 확인한 뒤 내보냅니다.
마크다운 표·CSV 자주 묻는 질문
마크다운 문서 전체를 붙여 넣어도 되나요?
네. GFM 파이프 표를 찾아 보여 주며 여러 표가 있으면 하나를 선택할 수 있습니다. 코드 블록이나 HTML 표는 변환 대상이 아닙니다.
마크다운 표의 정렬 콜론도 CSV에 들어가나요?
아닙니다. 구분선의 콜론은 화면 정렬 정보이며 CSV 셀 값에 포함하지 않습니다.
셀 안에 | 문자가 있으면 어떻게 쓰나요?
마크다운 입력에서는 \|로 이스케이프하세요. 그러면 한 셀의 | 문자로 읽습니다. CSV를 표로 바꿀 때는 도구가 이스케이프합니다.
CSV의 쉼표와 큰따옴표는 왜 늘어나 보이나요?
쉼표가 있는 셀은 큰따옴표로 감싸고 셀 안의 큰따옴표는 두 번 써야 열 경계와 구분됩니다. CSV를 다시 읽으면 원래 셀 값으로 복원됩니다.
CSV 첫 줄이 데이터일 때도 바꿀 수 있나요?
네. “첫 행을 머리글로 사용”을 끄면 열 1, 열 2 같은 머리글을 만들고 첫 줄을 포함한 모든 CSV 행을 표 본문에 넣습니다.
마크다운 표에서 열 수가 다른 행은 어떻게 되나요?
부족한 열은 빈 셀로 채우고 초과 열은 제외합니다. 도구가 경고를 표시하므로 저장 전에 해당 행을 확인하세요.
CSV 셀 안 줄바꿈도 완전히 보존되나요?
CSV 입력에서는 한 셀로 읽지만 마크다운 출력에서는 <br>로 바꿉니다. 원래 개행 문자 그대로의 왕복 보존은 지원하지 않습니다.
한글이 깨지면 어떻게 저장하나요?
CSV 파일을 바로 여는 프로그램이라면 기본으로 켜진 “UTF-8 표시 추가”를 사용해 보세요. 가져오기 기능을 쓴다면 UTF-8 인코딩을 직접 선택할 수도 있습니다.
수식형 셀 보호를 켜면 값이 바뀌나요?
네. 수식처럼 시작하는 일부 값에 보호용 접두가 추가되어 텍스트가 달라집니다. 모든 스프레드시트 프로그램과 재저장 경로의 안전을 보장하지는 않습니다.
선택한 문서 파일이 서버로 올라가나요?
아닙니다. 파일은 현재 브라우저에서 읽어 변환하며 입력 내용은 변환을 위해 서버로 보내거나 자동 저장하지 않습니다.
표 문법과 CSV 처리 근거
표의 머리글·구분선·열 수 규칙은 GitHub Flavored Markdown, CSV의 큰따옴표와 쉼표 처리는 RFC 4180을 기준으로 정했습니다. 수식형 셀과 UTF-8 다운로드는 아래 보안·제품 문서를 함께 참고했습니다. 이 규칙은 변환 형식을 설명하며 특정 스프레드시트 프로그램의 모든 가져오기 설정을 대신하지는 않습니다.
문서와 스프레드시트를 함께 다룰 때
- 텍스트 비교기 · 변환 전후 문서의 문장을 대조할 때
- CSV TSV 변환기 · 쉼표와 탭으로 나눈 데이터를 바꿀 때
- 글자수 세기 · 표에 들어갈 긴 문구의 길이를 확인할 때