Markdown 표 소스를 읽기 쉽게 유지하려면 셀에 공백을 넣고 긴 내용을 편집한 뒤 각 열을 다시 정렬하세요. Mac에서 Obsidian을 사용한다면 기본 표 편집기로 수정한 다음 Source 모드를 확인하세요. 소스의 공백 정렬과 렌더링된 텍스트 정렬은 따로 확인해야 합니다.

이 작업 방식은 데스크톱 메모에서 작은 Markdown 표를 관리하는 사람을 위한 것입니다. 독서 목록, 문구류 목록, 프로젝트 체크리스트 등을 예로 들 수 있습니다. 항목이 바뀌어도 실제 텍스트를 훑어보기 쉽게 유지하면서, 원하는 렌더러에서 표가 제대로 표시되도록 하는 것이 목표입니다.

Markdown 표 소스를 읽기 쉽게 만드는 요소는 무엇인가요?

읽기 쉬운 소스 표는 열 경계가 명확하고, 간격이 일정하며, 한 줄에 완전한 행 하나가 들어 있습니다. 고정폭 글꼴로 보면 파이프가 세로로 정렬됩니다. GitHub 문서에는 셀 너비가 일치하거나 소스 열이 완벽하게 정렬될 필요는 없다고 명시되어 있습니다. 따라서 정렬은 유효한 표를 만드는 요건이 아니라 편집을 편리하게 해 주는 방법입니다. 표로 정보 정리하기.

예를 들어 다음의 가상 표는 간결하지만, 항목 이름이 길어지면 훑어보기 어려워집니다.

| Item | Finish | Count |
| --- | --- | ---: |
| Pencil | Matte | 4 |
| Large sketchbook | Linen | 12 |

공백을 추가하면 같은 내용을 일반 텍스트로 볼 때 확인하기 더 쉽습니다.

| Item             | Finish | Count |
| ---------------- | ------ | ----: |
| Pencil           | Matte  |     4 |
| Large sketchbook | Linen  |    12 |

GFM에서는 파이프 경계와 셀 내용 사이의 공백을 제거합니다. 따라서 공백 채우기는 렌더링된 열 너비를 정하지 않습니다. ----:의 콜론은 렌더링된 열의 오른쪽 정렬을 지정합니다. 4 앞의 공백은 이 소스 예시를 훑어보기 쉽게 해 줄 뿐입니다. GitHub Flavored Markdown 사양, 표.

이 두 가지는 별개의 선택으로 다루세요. 소스를 읽기 위한 공백 정렬을 정하고, 렌더링된 텍스트 정렬을 위해 구분 행의 콜론을 선택하세요. 편집기에서 파이프 정렬이 고르지 않은 것이 문제라면 콜론을 바꿔도 해결되지 않습니다.

어떤 렌더러가 표를 읽나요?

파이프 표는 확장 기능이며, 핵심 CommonMark 기능은 아닙니다. 현재 CommonMark 사양은 버전 0.31.2이며, GitHub에서 공개한 GFM 사양은 표를 CommonMark의 확장 기능으로 명시합니다. CommonMark 호환이라고만 설명된 렌더러가 파이프 표도 지원한다고 보장되지는 않습니다. 표 확장 기능도 지원하는지 확인하세요. CommonMark 사양, GitHub Flavored Markdown 사양.

메모를 다른 앱으로 옮길 때는 다음 차이점이 중요합니다.

대상 문서에 명시된 동작 실용적인 선택
핵심 CommonMark 핵심 사양에는 파이프 표 구문이 없음 표 확장 기능을 사용할 수 있는지 확인
GitHub 표 안내에 따르면 구분 셀마다 하이픈이 3개 이상이어야 함 --- 또는 그 이상 사용
Obsidian 표 안내에 따르면 하이픈은 최소 2개면 되고, 소스 셀 정렬은 필수가 아님 GitHub에서도 사용할 표라면 3개 이상 사용

위의 하이픈 개수 요건은 각 제품 안내에 따른 것입니다. 두 대상에서 함께 쓰기 위한 편리한 공통 규칙으로 3개 이상을 사용할 수 있지만, 모든 Markdown 렌더러가 동일하게 동작한다는 뜻은 아닙니다. GitHub 표 문서, Obsidian 고급 서식 구문.

Obsidian과 GitHub에서 모두 사용할 표라면 앞뒤 파이프를 사용하고, 공백으로 간격을 맞추며, 표 앞뒤에 빈 줄을 두세요. GitHub 안내에서는 표 앞에 빈 줄을 두라고 합니다. GFM 사양에는 빈 줄이 표를 끝낸다고 명시되어 있습니다. 경계를 분명히 해 두면 소스에서 표를 찾기도 쉬워집니다. GitHub 표 문서, GFM 표 경계.

Mac의 Obsidian에서 표를 관리하는 방법

Obsidian은 셀을 편리하게 편집하고 이후에 Markdown을 읽기 쉽게 유지하려는 사용자에게 유용한 작업 흐름을 제공합니다. Obsidian 데스크톱 1.5.8 릴리스 노트에서는 입력 중 표를 자동으로 서식 지정하는 기능을 소개하며, Source 모드에서 열을 더 깔끔하게 볼 수 있다고 설명합니다. 이는 Markdown 구문 기능이 아니라 문서화된 편집기 동작입니다. Obsidian 1.5.8 데스크톱 릴리스 노트.

일반적인 메모에서는 다음 순서로 작업하세요.

  1. 메모를 Live Preview에서 엽니다. 필요하면 편집기의 상태 아이콘에서 해당 모드를 선택합니다.
  2. Insert Table 명령을 사용하거나 마우스 오른쪽 버튼을 클릭한 뒤 Insert → Table을 선택해 표를 삽입합니다.
  3. 표 편집기에서 셀 내용을 입력하거나 수정합니다. 행과 열을 추가, 삭제, 이동 또는 정렬하려면 표를 마우스 오른쪽 버튼으로 클릭합니다.
  4. 상태 아이콘에서 Source mode를 선택하고 결과 Markdown을 확인합니다.
  5. Reading view로 전환해 표시된 표를 확인합니다.

모드 제어 방법은 보기 및 편집 모드에, 표 삽입 및 컨텍스트 메뉴 작업은 고급 서식 구문에 설명되어 있습니다.

자주 전환한다면 Toggle Live Preview/Source mode에 단축키를 지정하세요. macOS에서 Cmd+E는 읽기 보기와 편집 보기 사이를 전환합니다. 두 편집 모드 사이를 오가려는 경우에는 전용 모드 명령을 사용하세요. Obsidian 보기 및 편집 모드.

Source mode에서 직접 입력한 뒤 공백 정렬이 고르지 않다면 기본 표 편집기로 돌아가 추가 편집을 하고, 이후 소스를 확인하세요. 인용된 문서에서는 표의 자동 서식 지정과 소스를 정확히 확인하는 방법을 설명하지만, 임의로 소스를 편집할 때마다 공백이 즉시 다시 정렬된다고 보장하지는 않습니다. 작은 표의 정렬이 계속 고르지 않다면 아래의 수동 방법으로 직접 조정할 수 있습니다.

긴 내용을 편집한 뒤 소스 열을 다시 정렬하는 방법

간단한 규칙을 따르세요. 각 소스 열의 너비를 머리글을 포함해 현재 가장 긴 항목에 맞춥니다. 해당 열의 나머지 셀에 공백을 채웁니다. 항목이 기존 공간보다 길어지면 다시 계산하세요.

일반 ASCII 텍스트만 사용하는 작업 예시는 다음과 같습니다. 먼저 이 표를 준비합니다.

| Item   | Finish | Count |
| ------ | ------ | ----: |
| Pencil | Matte  |     4 |
| Folder | Linen  |    12 |

이제 Folder를 Large sketchbook으로 바꿉니다. 새 항목은 16자이므로 첫 번째 열의 내용 영역을 16자로 맞춰야 합니다. 각 경계 파이프 바로 안쪽에 공백 하나를 두고, 그 내용 영역을 채울 만큼 뒤쪽에 공백을 추가하세요.

  • Item은 4자이므로 뒤에 공백 12개를 넣고 경계 공백을 하나 더 둡니다.
  • Pencil은 6자이므로 뒤에 공백 10개를 넣고 경계 공백을 하나 더 둡니다.
  • Large sketchbook은 16자 영역을 채우므로 뒤에는 경계 공백만 두면 됩니다.
  • 시각적인 기준을 맞추려면 첫 번째 구분 셀의 하이픈을 16개로 늘립니다.

결과는 앞서 본 공백이 채워진 표입니다. 첫 번째 열만 넓히면 됩니다. 나머지 열은 간격과 정렬 표시를 그대로 유지합니다.

이 방법은 설명한 ASCII 예시에 적용하는 수동 서식 지정 방식이지, 일반적인 문자 너비 계산법은 아닙니다. 일상적인 편집에서는 고정폭 소스 보기에서 결과를 확인하세요. 셀에 인라인 서식이 많이 들어 있다면 백틱이나 별표 같은 문장 부호를 포함해 실제로 쓰인 문자 수를 기준으로 소스 너비를 판단하세요.

편집을 여러 번 한 뒤에는 키를 누를 때마다 행을 조정하기보다 한 번에 표를 정렬하세요. 항목이 자주 문단 길이로 늘어난다면 표에는 짧은 레이블만 두고 설명은 아래 일반 문장으로 옮기는 방법을 고려하세요. 이렇게 하면 정보는 줄이지 않고 공백을 관리해야 하는 양을 줄일 수 있습니다.

표가 깨졌을 때 확인할 내용은 무엇인가요?

공백을 조정하기 전에 표의 구조부터 확인하세요. GFM에서는 머리글 행과 구분 행의 셀 개수가 같아야 합니다. 본문 행의 셀 수가 부족하면 빈 셀이 추가되고, 넘치면 초과 셀은 무시됩니다. 따라서 표가 얼핏 정상으로 보여도 렌더링된 결과에서 내용이 빠질 수 있습니다. GFM 표 파싱 규칙.

크게 편집한 뒤에는 다음 순서로 점검하세요.

  1. 머리글 행과 구분 행을 비교합니다. 각 머리글에 대응하는 구분 셀을 둡니다.
  2. 모든 본문 행을 확인합니다. 값이 비어 있어도 필요한 셀 수를 유지합니다.
  3. 내용 안의 파이프 문자를 찾습니다. 이스케이프되지 않은 파이프는 또 다른 경계로 해석될 수 있습니다.
  4. 행 경계를 확인합니다. 각 표 행은 소스에서 한 줄로 유지하고 표 안에 빈 줄을 넣지 않습니다.
  5. 대상 렌더러에서 미리 봅니다. 표의 모양뿐 아니라 표시된 값도 확인합니다.

파이프 문자를 그대로 표시하는 방법으로 GitHub는 문자 앞에 백슬래시를 넣도록 안내합니다. 다음 예시에서는 Blue | Green이 한 셀 안에 유지됩니다.

| Item   | Options       |
| ------ | ------------- |
| Folder | Blue \| Green |

이스케이프는 구조를 바꿉니다. 이스케이프되지 않은 파이프 주위에 공백을 더 넣어도 문제가 해결되지는 않습니다. GitHub의 파이프 문자 예시.

Obsidian에서는 표 안의 내부 링크 별칭에 쓰이는 파이프도 이스케이프해야 한다고 안내합니다. 이는 Obsidian에만 해당하는 구문 관련 고려 사항이므로, 별칭을 이스케이프해도 GitHub에서 링크가 똑같이 작동한다고 볼 수는 없습니다. Obsidian 표 서식 안내.

소스를 좁아 보이게 하려고 긴 셀의 중간에서 Enter를 누르지 마세요. GFM 표는 인라인 콘텐츠를 허용하고 블록 요소는 제외하며, 소스 셀을 일반적으로 여러 줄에 걸쳐 작성하는 형식을 제공하지 않습니다. 한 줄짜리 행을 유지하기 어려울 만큼 설명이 길다면 표 밖으로 옮기세요. GFM 표 콘텐츠 규칙.

관리 절차는 간단하게 유지하세요. 내용을 수정하고, 셀 경계를 확인하고, 영향을 받은 열에 공백을 채운 다음 렌더링된 표를 검토합니다. Obsidian에서는 기본 표 편집기로 수정한 뒤 Source mode에서 확인하는 것이 실용적인 시작점입니다. 특정한 일반 텍스트 레이아웃을 원한다면 공백을 수동으로 조정하면 됩니다.

출처