CSV→Markdown 표 변환기

CSV 파일을 Markdown 표 문법(`| col1 | col2 |`)으로 변환합니다. 구분자, 첫 줄을 표제행으로 사용할지 여부, 열 정렬(왼쪽·가운데·오른쪽)을 지정할 수 있습니다. 변환 결과는 복사하거나 다운로드할 수 있습니다. 변환은 모두 브라우저 내에서 처리되며 서버로 전송되지 않습니다.

구분자
첫 줄을 표제행으로 사용
열 정렬 

            
            복사했습니다!
            
          

          
CSV를 입력하면 여기에 Markdown 표가 표시됩니다.

        

      


      
      

        

          
CSV 행과 Markdown 표의 대응 관계

          

            

              
                

                  CSV의 한 행
                  name,age,city
                

                

                  변환된 Markdown 문법
                  | name | age | city |
                

              
            

          

          
첫 줄을 표제행으로 사용하면 1행이 표제행이 되고, 2행에 정렬을 나타내는 구분행(---)이 이어지며, 3행부터는 각 데이터 행이 됩니다.

        

      

    

  

  

  
  
  

    

      

        
팁

        
    
                      
  • 셀 안에 파이프(|)가 포함되어 있으면 자동으로 \|로 이스케이프되어 열 구분자로 잘못 인식되는 것을 방지합니다.
    • 
                      
  • 따옴표로 묶인 여러 줄 셀 안의 줄바꿈은 반각 공백으로 치환됩니다. Markdown 표의 한 행은 물리적으로 한 줄에 들어가야 하기 때문입니다.
    • 
                      
  • "왼쪽 정렬", "가운데 정렬", "오른쪽 정렬" 중 하나를 선택하면 구분행에 `:---`·`:---:`·`---:`가 삽입되어 GitHub 등의 렌더러에서 의도한 정렬로 표시됩니다.
    • 
                      
  • 자매 도구인 CSV→JSON 변환·CSV→SQL 변환과 함께 사용하면, 하나의 CSV를 용도에 맞는 세 가지 형식으로 변환할 수 있습니다.
    • 
                  

      

    

  


      

      

        

          
자주 묻는 질문

          

                          

                

                  
                

                

                  
파이프(|)로 구분한 셀을 한 줄에 나열하고, 표제행 바로 다음에 `---`로 이루어진 구분행을 삽입하여 표로 인식되게 하는 표기법입니다. GitHub의 README를 비롯해 Qiita·Zenn 등 많은 Markdown 렌더러가 지원합니다.

                

              

                          

                

                  
                

                

                  
구분행의 하이픈 앞뒤에 콜론(:)을 붙여 지정합니다. `:---`는 왼쪽 정렬, `:---:`는 가운데 정렬, `---:`는 오른쪽 정렬을 의미하며, 이 도구에서는 정렬 옵션을 선택하기만 하면 자동으로 삽입됩니다.

                

              

                          

                

                  
                

                

                  
네. 따옴표로 묶인 셀 안의 쉼표는 열 구분자로 오인되지 않으며, 줄바꿈은 반각 공백으로 변환되므로 Excel 등에서 복사한 복잡한 CSV도 표 형식이 깨지지 않고 변환됩니다.

                

              

                          

                

                  
                

                

                  
아니요. 변환 처리는 모두 브라우저 내 JavaScript에서 이루어지며, 입력한 CSV 내용이 서버로 전송되는 일은 없습니다.

                

              

                      

        

      

    


    
  
  
  
  

    

      

        ツールくん
        
여담 ― Markdown 표는 왜 파이프와 하이픈만으로 표현될까

                  
Markdown은 2004년 John Gruber와 Aaron Swartz가 고안한 경량 마크업 언어로, "평문 그대로 읽어도 의미가 통해야 한다"는 것을 설계 철학의 핵심으로 삼고 있습니다. 표 문법도 예외가 아니어서, 파이프와 하이픈만으로 표의 선을 표현하기 때문에 HTML의 `
` 태그처럼 시작·종료 태그로 감쌀 필요가 없고, 변환 전 소스만 보고도 표의 형태를 대략 짐작할 수 있습니다.
Markdown의 표 문법은 원래 John Gruber 본인이 정한 오리지널 규격에는 포함되어 있지 않았고, 이후 PHP Markdown Extra와 더 큰 영향력을 가진 GitHub Flavored Markdown(GFM)이 독자적으로 추가한 확장 기능입니다. 그래서 구현에 따라 세부 동작(열 개수가 맞지 않을 때의 처리 등)이 미묘하게 다를 수 있으며, GitHub·GitLab 등 주요 플랫폼은 대체로 GFM을 따르고 있습니다.
스프레드시트나 데이터베이스 조회 결과를 그대로 문서에 붙여넣고 싶은 수요는 README·Issue·기술 블로그를 작성할 때 자주 발생합니다. 파이프와 구분행을 손으로 직접 입력하는 것은 번거로운 작업이므로, CSV에서 한 번에 변환할 수 있는 도구는 Markdown으로 문서를 작성하는 개발자들에게 정착된 사전 작업이 되었습니다.

  

    

      
같은 카테고리의 도구