JSON을 Markdown으로

관련 추천

JSON을 Markdown으로 변환과 Markdown 테이블에 관하여

사용 사례

• 기술 문서 작성 시 API가 반환한 JSON 데이터를 Markdown 테이블로 변환하여 표시
• GitHub README에 구성 데이터, 매개변수 설명, API 응답 예시 표시 필요 시
• 데이터 보고서를 Markdown 테이블로 분석 결과 제시(내보내기 후 Notion/Confluence에 삽입 가능)
• API 문서(Swagger/Redoc/OpenAPI)에서 인터페이스가 반환하는 데이터 구조를 명확하게 표시
• VuePress/Docusaurus/Hexo 등 정적 사이트 생성기의 문서 섹션
• Slack/Discord/기업 메신저에서 구조화된 데이터 공유(GFM이 이 플랫폼에서 기본 지원됨)
• VS Code/JetBrains IDE의 Markdown Preview에서 테이블 효과 즉시 미리보기
• 버전 관리 협업: Markdown 테이블은 순수 텍스트로 git diff에 친화적이며 Code Review에 편리
• 교육 시나리오: 데이터 구조 수업에서 학생들이 제출한 중첩 JSON 과제를 테이블로 변환하여 통일된 표시 및 채점
• 이메일 템플릿(Bear Mail, HEY 등 Markdown 지원 이메일 클라이언트)
• Notion 데이터베이스 가져오기: 먼저 이 도구로 Markdown 테이블을 생성한 다음 Notion에 붙여넣기
• 국제화 시나리오: JSON 평탄화 + 키 이름 정리 후 한중 문서가 동일한 구조를 공유

이용 방법

1. 왼쪽 편집기에 JSON 배열(권장) 또는 중첩 객체를 붙여넣거나 'Sample'을 클릭하여 3개의 중첩 사용자 샘플을 로드하거나 'Upload'를 클릭하여 .json/.txt 파일 업로드
2. 도구 모음에서 중첩 처리 모드 선택('Flatten(평탄화)' 권장), JSON에 여러 계층 중첩이 있는 경우 Max Depth를 높게 조정
3. 사용자 정의 구분 기호가 필요한 경우 Separator 입력 상자에 입력(기본값 `.`, `_`/`-`/`/`로 변경 가능)
4. Strategy 선택: 단일 배열은 'Single', 여러 배열 필드는 'Multi'로 자동 분할, 강제 분할은 'Split'
5. 스타일 옵션 선택: Sort columns(열 정렬), Beautify keys(키 이름 정리), Exclude empty(빈 열 제외), Include Caption(제목), Include Index(행 인덱스)
6. 정렬 방식 선택: 왼쪽 정렬/가운데 정렬/오른쪽 정렬
7. 'Convert' 버튼 클릭(또는 Enter 키 직접 입력)으로 변환 실행; 입력 시 500ms 디바운스 보호 적용
8. 오른쪽에서 생성된 Markdown 테이블 코드 확인 후 만족하면 'Copy'를 클릭하여 코드를 복사해 Markdown 문서에 붙여넣거나 'Download'를 클릭하여 table.md 파일로 다운로드

주요 기능

• 중첩 객체 자동 평탄화: `{user:{name,age}}`를 `user.name`, `user.age`와 같은 점 표기법 키 이름으로 재귀적 확장(깊이 1~6단계 조절 가능), 수동 평탄화 스크립트 불필요
• 4가지 중첩 처리 모드: 평탄화(권장, 깊이 조절 가능) / 첫 번째 계층 키(중첩 객체를 단일 열 JSON으로) / 문자열화(중첩 객체를 JSON 문자열로 변환) / Raw JSON(각 행을 완전한 JSON 블록으로)
• 스마트 다중 테이블 분할: JSON 최상위 배열 필드(`users`, `orders` 등)를 인식하고 자동으로 여러 독립 Markdown 테이블로 분할 및 ### 제목 생성, 복잡한 비즈니스 데이터에 적합
• 사용자 정의 구분 기호: 평탄화 모드 기본값 `.`(`user.name`, Lodash/MongoDB 규칙 준수), 도구 모음에서 `_` / `-` / `/` 등으로 사용자 정의 가능
• 키 이름 정리(camelCase/snake_case → Title Case): `user_name`을 자동으로 `User Name`으로, `userProfileId`를 자동으로 `User Profile Id`로 변환하여 헤더를 사람이 읽기 쉽게 만듦
• 열 정렬 스위치: 한 번의 클릭으로 모든 헤더 열을 알파벳 순서로 정렬, 여러 Markdown 문서를 비교할 때 열 순서를 안정적으로 일관되게 함
• 빈 값 열 제외: 모든 행이 null/undefined/빈 문자열인 열을 자동 감지하여 제외, 의미 없는 열이 공간을 차지하지 않도록 방지
• 3가지 정렬 방식: 왼쪽 정렬(`:-`)/가운데 정렬(`:-:`)/오른쪽 정렬(`-:`), 라디오 버튼 전환, GFM 사양 준수
• 행 인덱스 열 스위치: 선택적으로 가장 왼쪽에 `#` 번호 열 추가(헤더 텍스트 사용자 정의 가능), 문서에서 행 번호 참조에 편리
• Caption 제목 스위치: 각 테이블 위에 `### 데이터 이름` 3단계 제목(H3) 자동 생성, 장별 문서에서 구조가 명확하고 SEO에 도움
• 유형 인식 이스케이프: 셀 내의 `|` / `\` / 줄 바꿈 문자를 자동으로 `\|` / `\\` / `<br>`로 이스케이프, Markdown 테이블 구문 파괴 방지
• 생성 통계 피드백: 하단 상태 표시줄에 'N개 테이블 × M행 × K열 생성' + 바이트 수 실시간 표시, 긴 JSON 디버깅 시 데이터 규모를 한눈에 파악
• 샘플 데이터 + 파일 업로드: 내장된 3개의 중첩 사용자 샘플을 한 번의 클릭으로 로드, 드래그 앤 드롭 또는 클릭으로 .json/.txt 파일 업로드 지원
• 완전한 브라우저 로컬 처리: 모든 JSON 구문 분석, 중첩 평탄화, Markdown 생성, 복사/다운로드 작업이 브라우저 내에서 완료되며 데이터는 어떤 서버에도 업로드되지 않음

코드 예제

// 1) GitHub API를 호출하여 사용자 목록 가져오기
async function fetchUsers() {
  const res = await fetch('https://api.github.com/users?per_page=10');
  return await res.json();
}

// 2) 중첩 평탄화 함수(이 도구의 평탄화 로직과 동등)
function flattenObject(obj, prefix = '', sep = '.', result = {}, depth = 0, maxDepth = 3) {
  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) return result;
  if (depth >= maxDepth) {
    if (prefix) result[prefix] = JSON.stringify(obj);
    return result;
  }
  for (const [k, v] of Object.entries(obj)) {
    const key = prefix ? `${prefix}${sep}${k}` : k;
    if (v && typeof v === 'object' && !Array.isArray(v)) {
      flattenObject(v, key, sep, result, depth + 1, maxDepth);
    } else {
      result[key] = v;
    }
  }
  return result;
}

// 3) 평탄화된 데이터를 Markdown 테이블로 변환
function generateMarkdownTable(rows, opts = {}) {
  const { align = 'left', includeIndex = false, sortColumns = false } = opts;
  const flat = rows.map(r => flattenObject(r));
  let cols = [...new Set(flat.flatMap(r => Object.keys(r)))];
  if (sortColumns) cols.sort((a, b) => a.localeCompare(b));

  const alignMap = { left: ':-', center: ':-:', right: '-:' };
  const alignSep = alignMap[align];

  const headers = includeIndex ? ['#', ...cols] : cols;
  const seps = includeIndex ? [alignSep, ...cols.map(() => alignSep)] : cols.map(() => alignSep);

  const escapeCell = v =>
    v == null ? '' :
    typeof v === 'object' ? JSON.stringify(v).slice(0, 60) :
    String(v).replace(/\\|/g, '\\|').replace(/\n/g, '<br>');

  const lines = [];
  lines.push('| ' + headers.join(' | ') + ' |');
  lines.push('| ' + seps.join(' | ') + ' |');
  flat.forEach((r, i) => {
    const idxCell = includeIndex ? [i + 1] : [];
    const cells = cols.map(c => escapeCell(r[c]));
    lines.push('| ' + [...idxCell, ...cells].join(' | ') + ' |');
  });
  return lines.join('\n');
}

// 4) README.md에 출력
const users = await fetchUsers();
const md = generateMarkdownTable(... [truncated]

from flask import Flask, jsonify
import json

app = Flask(__name__)

def flatten(obj, prefix='', sep='.', result=None, depth=0, max_depth=3):
    """중첩 객체를 재귀적으로 평탄화"""
    if result is None:
        result = {}
    if not isinstance(obj, dict) or depth >= max_depth:
        if prefix:
            result[prefix] = json.dumps(obj) if isinstance(obj, (dict, list)) else obj
        return result
    for k, v in obj.items():
        key = f"{prefix}{sep}{k}" if prefix else k
        if isinstance(v, dict):
            flatten(v, key, sep, result, depth + 1, max_depth)
        else:
            result[key] = v
    return result

def json_to_markdown_table(data, align='left', include_index=False,
                            sort_columns=False, caption=None):
    if isinstance(data, dict):
        data = [data]
    if not data:
        return "<!-- No valid objects found -->"

    flat_rows = [flatten(row) for row in data]
    columns = []
    for row in flat_rows:
        for k in row:
            if k not in columns:
                columns.append(k)
    if sort_columns:
        columns.sort()

    align_sep = {'left': ':-', 'center': ':-:', 'right': '-:'}[align]
    headers = (['#'] if include_index else []) + columns
    seps = ([align_sep] if include_index else []) + [align_sep] * len(columns)

    def escape_cell(v):
        if v is None:
            return ''
        if isinstance(v, (dict, list)):
            s = json.dumps(v)
            return s[:60] + '…' if len(s) > 60 else s
        return str(v).replace('|', '\\|').replace('\n', '<br>')

    lines = []
    if caption:
        lines.append(f'### {caption}\n')
    lines.append('| ' + ' | '.join(headers) + ' |')
    lines.append('| ' + ' | '.join(seps) + ' |')
    for i, row in enumerate(flat_rows):
        idx_cell = [str(i + 1)] if include_index else []
        cells = [escape_cell(row.get(c, '')) for c in columns]
        lines.appe... [truncated]

# 1) gh CLI로 최근 50개 merged PR 가져오기
PR_JSON=$(gh pr list --state merged --limit 50 --json number,title,author,labels,mergedAt)

# 2) jq로 labels 중첩 배열 평탄화(이 도구의 평탄화 로직과 동등)
echo "$PR_JSON" | jq 'map({
  number: .number,
  title: .title,
  author: .author.login,
  labels: (.labels | map(.name) | join(", ")),
  mergedAt: .mergedAt
})' > release_prs.json

# 3) 이 도구 열기(https://geekformat.com/json/to-markdown/)
#    - release_prs.json 내용 붙여넣기
#    - 도구 모음 Strategy에서 "Single" 선택
#    - Sort columns + Include Index 선택
#    - Convert 클릭
#    - 생성된 Markdown 테이블 복사

# 4) Release Notes에 결합
cat > RELEASE.md <<'EOF'
# v2.1.0 Release Notes

## 🆕 What's Changed

EOF

# 이전 단계에서 복사한 테이블을 여기에 붙여넣기(또는 sed로 주입)
sed -i '/## 🆕/r /tmp/table.md' RELEASE.md

cat >> RELEASE.md <<'EOF'

**Full Changelog**: https://github.com/your/repo/compare/v2.0.0...v2.1.0
EOF

# 5) gh CLI로 Release 생성
gh release create v2.1.0 -F RELEASE.md -t "v2.1.0"

자주 묻는 질문

문제 해결

용어집

Markdown 테이블

|와 - 문자로 구성된 순수 텍스트 테이블로, GFM(GitHub Flavored Markdown) 사양에 정의됨. 이 도구가 생성하는 코드는 이 구문을 엄격히 준수하며 GitHub/GitLab/Notion/Confluence에서 직접 렌더링 가능.

GFM

GitHub Flavored Markdown의 약어. GitHub가 표준 Markdown 위에 확장한 방언으로, 테이블, 취소선, 작업 목록, 자동 링크 등 포함. 이 도구가 생성하는 테이블은 GFM 사양 준수.

CommonMark

Markdown 문법의 표준화 사양(2014년 발표). GFM 테이블 구문은 CommonMark 위에 확장됨. 이 도구의 출력은 엄격한 CommonMark 파서와 GFM 파서 모두에서 올바르게 렌더링 가능.

JSON 배열

대괄호 [...]로 둘러싸인 객체 집합. 이 도구는 배열의 각 객체를 테이블의 한 행으로 처리. 빈 배열인 경우 테이블을 생성하지 않음(힌트 표시).

JSON 객체

중괄호 {}로 둘러싸인 키-값 쌍 집합. 이 도구는 객체의 각 키를 헤더로, 값을 셀로 처리. 단일 객체는 자동으로 단일 행 테이블로 래핑됨.

중첩 평탄화(Flatten)

중첩 객체를 점으로 구분된 평면 키 이름으로 재귀 확장. 예: {user:{name:'A'}} → 'user.name'. 이 도구는 1~6계층 깊이 자동 평탄화 지원, 구분 기호 구성 가능.

키 이름 정리(Beautify Keys)

snake_case 또는 camelCase 키 이름을 Title Case로 변환하는 규칙: user_name → User Name, userProfileId → User Profile Id. 이 도구의 차별화 능력 중 하나.

스마트 다중 테이블 분할(Multi-Table Split)

JSON 최상위 배열 필드(users, orders 등)를 인식하고 자동으로 여러 독립 Markdown 테이블로 분할. 이 도구의 차별화 능력 중 하나. 분할된 각 테이블에 자동으로 ### 제목 생성.

정렬 구문(Alignment)

GFM 테이블의 헤더 구분 행은 : 문자로 정렬 제어 지원: :- 왼쪽 정렬, :-: 가운데 정렬, -: 오른쪽 정렬. 이 도구는 세 개의 버튼으로 한 번의 클릭 전환 제공.

행 인덱스 열(Index Column)

테이블 가장 왼쪽에 추가되는 # 번호 열(1부터 증가), 헤더 텍스트 사용자 정의 가능. 이 도구는 기본적으로 비활성화되어 있으며 활성화 시 문서에서 행 번호 참조가 용이함.

Caption

Markdown의 H3 3단계 제목(###). 이 도구는 생성된 각 테이블 위에 자동으로 이 레이블 추가(기본적으로 최상위 배열 필드명 또는 사용자 정의 텍스트 사용). 문서 탐색과 SEO 모두에 도움.

열 정렬(Sort Columns)

테이블의 모든 열을 알파벳 순서로 정렬하는 스위치. 활성화 시 여러 문서 비교에서 열 순서가 안정적으로 일관되며, diff 도구에서 보이는 변경 사항을 더 쉽게 식별 가능.

빈 열 제외(Exclude Empty)

모든 행에서 특정 열이 모두 null/undefined/빈 문자열인 경우 해당 열 자동 제외. 이 도구는 기본적으로 비활성화되어 있으며 활성화 시 희소 데이터의 테이블 너비를 크게 줄임.

Markdown 이스케이프(Escape)

Markdown 테이블에서 특별한 의미를 가진 문자(|, \, 줄 바꿈 등)를 안전한 형식(\|, \\, <br>)으로 변환하여 테이블 구문 파괴 방지. 이 도구는 이 이스케이프를 자동으로 수행하며 경쟁 도구 대비 주요 업그레이드.

로컬 기록(localStorage)

브라우저가 제공하는 로컬 키-값 저장소(용량 약 5-10MB). 이 도구는 localStorage를 사용하여 최근 입력을 영구 저장, 새로고침이나 실수로 페이지를 닫은 후 빠르게 복구 가능.

디바운스(Debounce)

프런트엔드 성능 최적화 기법: 고빈도 이벤트(입력 등)의 콜백을 마지막 트리거 후 한 번만 실행하도록 통합. 이 도구는 500ms 디바운스를 설정하여 대용량 파일 구문 분석 시 지연 방지.

4가지 중첩 객체 처리 모드 비교표

도구 모음은 다양한 중첩 시나리오에 대응하는 4가지 모드를 제공합니다. JSON 구조의 복잡성에 따라 선택하는 것이 좋습니다:

3가지 테이블 생성 전략 비교표

도구 모음의 Strategy 드롭다운은 여러 배열 필드를 포함하는 JSON의 처리 방법을 제어합니다:

도구 모음 14가지 구성 가능 옵션 빠른 참조표

도구 모음의 전체 14가지 구성 가능 옵션과 그 효과. 조합을 빠르게 선택하기 위해:

Markdown 셀 이스케이프 규칙 빠른 참조표

도구는 셀 내에서 테이블 의미를 파괴할 수 있는 특수 문자를 자동으로 이스케이프합니다:

Privacy & Security

이 JSON을 Markdown으로 변환 도구의 모든 JSON 구문 분석, 중첩 평탄화, Markdown 생성, 복사/다운로드 작업은 완전히 브라우저 로컬에서 JavaScript로 수행되며 입력된 JSON 데이터와 생성된 Markdown 코드는 어떤 서버에도 업로드되지 않고 기록, 캐시, 클라우드 저장되지 않습니다. 비공개 API 응답이나 내부 비즈니스 필드가 포함된 민감한 JSON도 안심하고 사용할 수 있으며 페이지를 닫으면 모든 데이터가 삭제됩니다.

Authoritative References

• GitHubGitHub Flavored Markdown 사양 - 테이블(Tables)
• CommonMarkCommonMark 사양
• MarkdownMarkdown 공식 문서(Daring Fireball)
• MDNMDN - JSON.parse / JSON.stringify
• GitHubGitHub Docs - Markdown에서 정보 구성하기
• LodashLodash - flatten / flattenDeep
• jqjq 매뉴얼 - 중첩 객체 처리