Markdown 표에서 Chart 만들기

이 페이지의 목표는 project-metrics.md의 Markdown 표를 그대로 유지하면서 전체 표 또는 선택 범위를 Chart로 보는 것이다. Chart가 복사한 dataset을 별도 원본으로 소유한다고 가정하지 않고, table source와 sourceRange를 다시 확인하는 데 초점을 둔다.

준비 파일

공용 예제의 project-metrics.md를 사용한다.

# 파일럿 문서 지표

| 챕터 | 문서 수 | 예상 분량 | 이미지 | 영상 |
| :--- | ---: | ---: | ---: | ---: |
| 첫 프로젝트 | 6 | 1800 | 3 | 0 |
| Markdown Kanban | 5 | 2200 | 3 | 1 |
| 보기모드 레퍼런스 | 8 | 3200 | 6 | 1 |

첫 번째 열은 label이고 나머지 열은 수치 series다. 숫자 열에 단위나 쉼표를 섞기 전에 순수 숫자로 가장 작은 성공 예제를 먼저 확인한다.

1. Source에서 원문 확인

  1. Shelf에서 project-metrics를 연다.
  2. 상단의 문서 작성 화면 아이콘을 선택한다.
  3. H1 아래에 pipe table 한 개가 있는지 확인한다.
  4. 세 데이터 행과 네 수치 열의 값을 원문과 대조한다.

project-metrics.md의 Markdown 원문 표를 연 Glif Desktop

이 화면에서 바꾸는 셀 값과 행 순서는 Markdown 파일에 저장된다. Chart 색상이나 axis 선택을 바꾼다고 이 값이 자동으로 다시 쓰여서는 안 된다.

2. Chart로 전환

  1. 문서 작성 화면 옆 보기 선택기를 연다.
  2. 차트를 선택한다.
  3. 문서 tab과 project-metrics identity가 그대로인지 확인한다.
  4. Chart card의 source 표시와 series legend를 확인한다.

같은 project-metrics.md를 Chart로 표시한 Glif Desktop

검증된 예제에서는 Chart card 한 개가 나타나고 label은 챕터, series는 문서 수, 예상 분량, 이미지, 영상이다. card에는 원본의 source line이 함께 표시된다.

3. 전체 표와 선택 범위 구분

  • 전체 표 chart intent는 현재 pipe table의 data 영역 전체를 참조한다.
  • 선택 범위 chart intent는 저장된 sourceRange로 label과 series 범위를 제한한다.
  • 범위를 바꿔도 원본 table cell을 별도 chart dataset으로 복사하지 않는다.
  • 원본 행·열 구조가 바뀌면 저장 범위가 여전히 유효한지 diagnostic을 확인한다.

Chart Info zone에서는 참조하는 table source와 sourceRange를 확인한다. 구조 조작은 Table의 action/menu가 소유하고, 지속되는 chart reference와 표현 설정은 Info zone 또는 projection profile이 소유한다.

4. 저장 결과 확인

  1. Chart를 닫지 않은 채 Source로 돌아간다.
  2. Markdown의 값과 행 순서가 전환 전과 같은지 확인한다.
  3. .glif/projections.json에서 현재 문서의 기본 보기와 chart profile을 확인한다.
  4. 앱을 다시 열어 Chart 선택과 유효한 source reference가 복원되는지 확인한다.
project-metrics.md             Markdown 값과 행·열 구조
.glif/projections.json         기본 보기, chart intent와 지원 profile

5. 문제가 생겼다면

증상 확인 복구
Chart가 비어 있다 수치 열이 실제 숫자인지 확인 단위·쉼표를 제거한 최소 표로 다시 확인
label이 잘못됐다 첫 열과 header 첫 열을 범주 label로 정리
일부 series가 없다 sourceRange 전체 표를 다시 선택하거나 유효한 범위를 저장
원본 변경 뒤 오류 table 행·열 수와 저장 범위 stale range diagnostic을 확인하고 범위를 다시 지정
Chart 수정이 원문을 바꿨다 Markdown diff undo 후 source/profile 책임 위반을 defect로 기록

되돌리기

기본 보기를 Source로 바꾸고 chart intent를 제거한다. 이 작업은 project-metrics.md의 표 값을 삭제하지 않아야 한다. 원문까지 바뀌었다면 저장 전에 undo하고 diff를 확인한다.

실증 정보

  • 캡처: Windows, 한국어, dark theme, Glif 0.1.0, 1200×830 client area
  • fixture: project-metrics.md, .glif/projections.json
  • 검증 화면: Source PNG + Chart PNG
  • 기능 ID: ED-23, TB-28, TB-29, TB-31

다음으로 Table과 Chart 보기 상세에서 두 보기의 전체 capability 경계를 비교한다.