Markdown 테이블을 손으로 포매팅하는 것은 번거롭습니다. 파이프를 세고, 대시를 맞추고, 컬럼을 정렬하는 데 시간을 낭비하기보다 내용 작성에 집중하고 싶을 겁니다. Markdown 테이블 생성기가 포매팅을 처리해 주므로 콘텐츠에만 집중할 수 있습니다.

Markdown 테이블 즉시 생성 →

60초 만에 GFM 테이블 문법 이해

GitHub Flavored Markdown(GFM) 테이블은 GitHub, GitLab, VS Code, Obsidian, Notion, 대부분의 Markdown 렌더러에서 지원되는 표준 형식입니다.

구조:

| 이름    | 역할      | 상태   |
|---------|-----------|--------|
| Alice   | Engineer  | Active |
| Bob     | Designer  | Active |
| Charlie | Manager   | Away   |

세 가지 규칙:

  1. 헤더 행: 파이프(|)로 구분된 컬럼명
  2. 구분자 행: 대시와 정렬을 위한 선택적 콜론
  3. 데이터 행: 줄당 하나의 레코드

이것이 전부입니다. 앞뒤 파이프는 선택 사항이지만 가독성을 위해 권장합니다.

컬럼 정렬

구분자 행의 콜론으로 정렬을 제어합니다:

문법정렬
--- 또는 :---왼쪽 (기본값)
:---:가운데
---:오른쪽

예 — 혼합 정렬:

| 항목     | 수량 |   가격  |
|:---------|:----:|--------:|
| Widget   |  10  |   $9.99 |
| Gadget   |   3  |  $24.99 |
| Doohickey|  25  |   $1.49 |

렌더링 후 항목 컬럼은 왼쪽 정렬, 수량은 가운데, 가격은 오른쪽 정렬됩니다. 숫자 컬럼에 유용합니다.

Markdown 테이블 생성기 사용법

도구는 세 가지 입력 모드를 제공합니다:

수동 비주얼 에디터

빈 그리드에서 시작해 셀에 직접 입력합니다. 버튼으로:

  • 행 추가 / 행 제거 — 테이블을 세로로 확장/축소
  • 컬럼 추가 / 컬럼 제거 — 가로 크기 조절
  • 정렬 선택기 — 각 헤더 셀의 드롭다운에서 왼쪽, 가운데, 오른쪽 선택

입력에 따라 Markdown 출력이 실시간으로 업데이트됩니다. 복사를 클릭해 포매팅된 테이블을 가져가세요.

최적 용도: 구조를 알고 소규모 데이터셋을 처음부터 만들 때.

CSV 붙여넣기

CSV 데이터를 붙여넣습니다 — 스프레드시트 내보내기, DB 쿼리 결과, 텍스트 파일에서. 도구가 구분자(쉼표, 탭, 세미콜론)를 자동으로 감지하고 비주얼 에디터와 Markdown 출력에 동시에 파싱합니다.

예 — 이것을 붙여넣으면:

language,paradigm,year
Python,multi-paradigm,1991
Go,concurrent,2009
Rust,systems,2015
TypeScript,typed,2012

이 Markdown 테이블을 얻습니다:

| language   | paradigm       | year |
|------------|----------------|------|
| Python     | multi-paradigm | 1991 |
| Go         | concurrent     | 2009 |
| Rust       | systems        | 2015 |
| TypeScript | typed          | 2012 |

최적 용도: 스프레드시트 데이터나 쿼리 결과를 문서 테이블로 변환할 때.

JSON 붙여넣기

객체의 JSON 배열을 붙여넣습니다. 키가 헤더 행이 되고 값이 데이터 행을 채웁니다. API가 레코드 목록을 반환하면 그대로 붙여넣을 수 있습니다.

예 — 이것을 붙여넣으면:

[
  { "endpoint": "/users", "method": "GET", "auth": true },
  { "endpoint": "/login", "method": "POST", "auth": false },
  { "endpoint": "/profile", "method": "PUT", "auth": true }
]

결과:

| endpoint | method | auth  |
|----------|--------|-------|
| /users   | GET    | true  |
| /login   | POST   | false |
| /profile | PUT    | true  |

최적 용도: API 응답, 설정 객체, 이미 JSON 형식으로 있는 구조화된 데이터 문서화.

셀 내용의 파이프 문자

GFM 테이블은 컬럼 구분자로 |를 사용하므로 셀 내용의 리터럴 파이프는 \|로 이스케이프해야 합니다. 생성기가 자동으로 처리합니다.

수동 예시:

| 표현식     | 의미               |
|------------|-------------------|
| `a \| b`   | 논리 OR           |
| `a && b`   | 논리 AND          |
| `a ?? b`   | Null 병합 연산자  |

수동으로 테이블을 작성할 때는 내용의 파이프 문자 이스케이프를 잊지 마세요. 비주얼 에디터나 가져오기 모드를 사용하면 도구가 자동으로 처리합니다.

주요 사용 사례

README 테이블 — 의존성 목록, 기능 비교 매트릭스, 설정 옵션. 실제로 가장 많이 쓰이는 Markdown 테이블입니다.

| 패키지       | 버전    | 라이선스 |
|--------------|---------|---------|
| react        | 18.3.0  | MIT     |
| typescript   | 5.4.5   | Apache  |
| eslint       | 9.0.0   | MIT     |

API 문서 — 엔드포인트 목록, 파라미터 테이블, 응답 필드 설명.

변경 로그 — 버전, 날짜, 요약 컬럼이 있는 구조화된 버전 이력.

데이터 비교 — 도구, 서비스, 접근 방식의 기능 비교를 나란히 표시.

코드에서 Markdown 테이블로 변환

코드로 정의된 데이터 구조(Python 딕셔너리 목록, Go 구조체 슬라이스, JavaScript 객체 배열)가 있으면 JSON 붙여넣기 탭에 JSON 표현을 붙여넣으세요. Python의 json.dumps(), Go의 JSON, JavaScript의 JSON.stringify()는 모두 도구가 파싱할 수 있는 JSON을 출력합니다.

import json

data = [
    {"tool": "Prettier", "lang": "JS/TS", "config": ".prettierrc"},
    {"tool": "Black", "lang": "Python", "config": "pyproject.toml"},
    {"tool": "gofmt", "lang": "Go", "config": "built-in"},
]

print(json.dumps(data, indent=2))
# 출력을 JSON 탭에 붙여넣기

Markdown 테이블의 제한 사항

GFM 테이블에는 알아둘 몇 가지 제약이 있습니다:

  • 셀 병합 없음: 모든 셀은 독립적입니다. 병합 셀을 위해서는 Markdown 내의 HTML <table> 요소를 사용하세요.
  • 여러 줄 셀 없음: 각 셀은 한 줄이어야 합니다. 좁은 보기에서는 긴 내용이 시각적으로 잘립니다.
  • 일반 텍스트만: 셀 안에서 인라인 Markdown(**bold**, `code`, [link](url))은 사용할 수 있지만, 블록 요소(코드 블록, 목록)는 테이블 셀 내에서 작동하지 않습니다.
  • 렌더링 필요: 원시 Markdown 테이블은 일반 텍스트 에디터에서 보기 불편합니다. 미리보기로 렌더링 출력을 확인하세요.

GFM 테이블 빠른 참조

요소문법
헤더 구분자---
왼쪽 정렬:---
가운데 정렬:---:
오른쪽 정렬---:
이스케이프 파이프|
셀 내 굵게**text**
셀 내 코드`code`
셀 내 링크[label](url)

파이프를 손으로 코딩하는 것을 멈추세요. Markdown 테이블 생성기 사용해보기 →