Markdown 표 셀 하나에 여러 줄을 표시하려면 행을 소스 한 줄로 유지하고 구문 사이에 <br>을 삽입하세요. 표와 인라인 HTML을 지원하는 곳에서 작동합니다. 사용하기 전에 Obsidian과 대상 렌더러에서 확인하세요.

이 안내서는 Obsidian에서 작은 표를 작성하고, 모양을 확인한 뒤, 같은 Markdown을 GitHub나 다른 렌더러에 사용할 수 있도록 준비하는 실용적인 Mac 데스크톱 작업을 다룹니다. 예시는 가상의 문구류 설명을 사용합니다. 아래 호환성 확인 방법은 문서에서 도출한 작업 흐름이며, 설치된 애플리케이션을 테스트한 결과는 아닙니다.

여러 줄 표 셀을 지원하는 Markdown 렌더러는 무엇인가요?

파이프 표는 확장 기능이며 핵심 CommonMark의 일부가 아닙니다. GitHub Flavored Markdown(GFM)은 셀에 인라인 콘텐츠를 허용하는 표를 추가합니다. 이 사양은 셀 안에 블록 요소를 허용하지 않습니다. 따라서 여러 줄로 표시되는 셀은 별도의 문단이나 Markdown 목록, 펜스 코드 블록이 들어 있는 셀과 다릅니다. GFM 표 사양을 참조하세요.

Obsidian은 파이프 표와 셀 내 서식을 문서화하고 있습니다. 기본 구문 설명서에는 <br>이 줄 바꿈 태그로 명시되어 있습니다. 표 페이지에 여러 줄 셀의 구체적인 예시는 없지만, 이 두 문서는 여기서 사용한 방법의 근거가 됩니다. 고급 서식 구문과 기본 서식 구문을 참조하세요.

긴 문서를 편집하기 전에 다음 판단 표를 확인하세요.

대상 문서화된 범위 실용적인 선택
확장 기능이 없는 핵심 CommonMark 파이프 표는 핵심 구문에 포함되지 않음 제목과 목록 사용
GFM 호환 렌더러 표는 인라인 콘텐츠를 허용하며 셀 안에 블록 요소는 허용하지 않음 인라인 줄 바꿈을 시도하고 대상에서 확인
Obsidian 표와 줄 바꿈 태그가 문서화되어 있음 소스를 편집한 다음 Reading view에서 확인
HTML 처리 방식이 알려지지 않은 렌더러 지원 여부가 확인되지 않음 형식을 결정하기 전에 아래의 간단한 비교 실행

첫 세 행은 위에 링크한 CommonMark 사양, GFM 사양, Obsidian 문서를 따릅니다. 마지막 행은 권장 확인 단계입니다. 렌더러 이름만으로 문서 처리 방식을 알 수는 없습니다.

셀 하나에 두 줄을 어떻게 작성하나요?

주변 코드 펜스는 복사하지 말고 다음 예시를 노트에 붙여 넣으세요. 각 표 행은 소스에서 물리적인 한 줄을 차지하며, 두 번째 셀의 구문 사이에 줄 바꿈 표시가 있습니다.

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |
| Pencil | Graphite core<br>Hexagonal shape |

예상 결과는 데이터 행이 두 개인 2열 표입니다. 첫 번째 상세 셀에는 “점선 페이지”가 “파란색 표지” 위에 표시됩니다. 두 번째에는 “흑연 심”이 “육각형 모양” 위에 표시됩니다. 이는 확인할 렌더링 결과이며, 대상 렌더러에서 실제로 어떻게 표시되는지 보여 주는 내장 예시는 아닙니다.

이 방법은 인라인 HTML 줄 바꿈과 표 구문을 함께 사용합니다. GitHub는 줄 바꿈을 만드는 지원 방법 중 하나로 HTML 줄 바꿈 태그를 안내하며, Obsidian도 <br>을 명시적으로 문서화합니다. HTML이 적용된 Markdown 셀이므로, 이 방식의 호환성은 대상에서 해당 마크업을 허용하는지에 따라 달라집니다. GitHub의 줄 바꿈 문서와 Obsidian의 기본 구문 문서를 참조하세요.

표 구조를 간단하게 유지하세요. 표 앞에 빈 줄을 두고, 머리글 열과 구분선 열의 수를 맞추며, 구분선 셀마다 하이픈 세 개를 사용하세요. GitHub의 표 안내서에는 빈 줄과 하이픈 세 개 규칙이 문서화되어 있습니다. Obsidian은 하이픈 두 개 이상을 허용하므로, 세 개를 사용하면 두 환경에서 편리하게 통용됩니다. 출처: 표로 정보 구성하기 및 고급 서식 구문.

Enter, 공백 두 개, 백슬래시로 해결되지 않는 이유는 무엇인가요?

CommonMark는 줄 끝에 공백 두 개를 넣거나 소스의 줄 바꿈 앞에 백슬래시를 두어 강제 줄 바꿈을 지원합니다. 이 규칙은 기존 블록 안의 인라인 콘텐츠에 적용되며, 여러 줄로 된 파이프 표 셀을 정의하지 않습니다. CommonMark의 강제 줄 바꿈을 참조하세요.

예를 들어 다음 방식은 두 구문을 하나의 GFM 셀 안에 유지하기에 적합하지 않습니다.

| Item | Details |
| --- | --- |
| Notebook | Dotted pages
Blue cover |

GFM 표 규칙에 따르면 소스의 두 번째 줄은 상세 셀의 이어지는 부분이 아니라 별도의 행이 됩니다. 빈 줄을 넣으면 표가 끝납니다. 전체 행을 한데 유지하고 표시되는 줄을 바꿀 위치에 인라인 줄 바꿈을 넣으세요. GFM 표 예시를 참조하세요.

자동 줄 바꿈과 의도적인 줄 바꿈도 구분하세요. 이 작업에서는 창 너비가 두 구문을 모두 표시하기에 충분한데도 두 번째 구문이 새 줄에서 시작해야 성공입니다. 좁은 창에서 찍은 스크린샷만으로는 이를 확인할 수 없습니다.

Mac의 Obsidian에서 표를 어떻게 확인하나요?

예시 표만 들어 있는 임시 노트를 사용하세요. 그러면 문제가 표 자체에서 비롯되었는지 주변 콘텐츠에서 비롯되었는지 파악하기 쉽습니다.

  1. 편집 모드 상태 컨트롤을 사용해 노트를 Source mode로 전환합니다. 이 모드에서는 작성한 그대로의 Markdown이 표시됩니다.
  2. 예시를 붙여 넣고 각 데이터 행이 소스에서 한 줄로 유지되는지 확인합니다.
  3. Cmd+E를 눌러 편집 보기와 Reading view 사이를 전환합니다.
  4. 두 상세 셀을 모두 확인합니다. 각각 두 줄로 표시되어야 하며, 어떤 구문도 새 표 행으로 옮겨지지 않아야 합니다.
  5. 편집 화면으로 돌아와 Live Preview에서도 결과를 비교합니다.

Obsidian은 보기 및 편집 모드에서 Source mode, Live Preview, Mac 단축키를 문서화합니다. Live Preview는 편집 중 대부분의 구문을 숨깁니다. Reading view는 서식이 적용된 노트를 별도로 확인하는 데 유용합니다.

나란히 비교하려면 Cmd를 누른 채 보기 전환기를 클릭해 편집 보기와 읽기 보기를 함께 엽니다. 해당 컨트롤이 숨겨져 있다면 Obsidian 문서에 나온 Settings → Appearance → Show tab title bar 설정을 사용하세요. 또는 Settings → Editor → Show editing mode in status bar에서 상태 표시줄 컨트롤을 사용할 수 있습니다. 보기 및 편집 모드를 참조하세요.

Obsidian의 기본 구문 안내서는 문단 줄 바꿈에 Shift+Enter를 사용하고 Strict Line Breaks 설정을 이용하는 방법을 설명합니다. 이러한 일반 문단 지침만으로 표 셀에서 이식성 있는 단축키를 쓸 수 있다고 볼 수는 없습니다. 이 확인에서는 Source mode에서 저장된 행을 살펴보고, 해당 설정을 표 호환성 해결책으로 간주하지 말고 명시적인 줄 바꿈 표시를 사용하세요. 기본 서식 구문을 참조하세요.

렌더러 차이를 빠르게 진단하려면 어떻게 하나요?

제안한 여러 줄 버전과 함께 일반 텍스트 대조 예시를 사용하세요. 다음 완전한 테스트 문서는 줄 바꿈 표시만 다르므로, 표 지원과 인라인 HTML 지원을 구분하기 쉽습니다.

Control:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages; blue cover |

Multiline candidate:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |

동일한 콘텐츠를 사용할 각 대상에서 엽니다. GitHub Markdown 파일이라면 렌더링된 파일 화면을 확인하세요. Obsidian 미리 보기로 확인되는 것은 Obsidian에서의 결과뿐입니다. GitHub는 일반 문단의 줄 바꿈 동작이 Markdown 파일과 대화 입력란에서 다르다고도 설명합니다. 따라서 실제 대상에서 확인하는 것이 중요합니다. 기본 작성 및 서식 구문을 참조하세요.

다음 관찰 결과를 바탕으로 이어서 확인할 항목을 결정하세요.

관찰 결과 다음 확인 항목
두 예시 모두 파이프로 구분된 텍스트처럼 표시됨 표 지원 여부를 확인하고 콘텐츠가 코드 펜스 밖에 있는지 확인
대조 예시는 작동하지만 후보 예시에서 태그가 그대로 출력됨 태그가 백틱 안에 들어갔거나 이스케이프되었는지 확인
대조 예시는 작동하지만 후보 예시에서 줄 바꿈이 사라짐 대상의 인라인 HTML 문서 확인
후보 예시에서 새 행이 생김 의도한 행 안에 실제 줄 바꿈이 있는지 소스 확인
구문이 사라지거나 열이 바뀜 셀 내용에 이스케이프되지 않은 파이프가 있는지 확인

이는 진단을 위한 분기이며, 모든 렌더러에서 확정적인 원인을 설명하지는 않습니다. 먼저 가장 작은 예시를 수정한 다음 표의 나머지 부분을 다시 추가하세요. 셀 텍스트에 파이프 문자를 그대로 넣으려면 GitHub 문서의 예시 Dotted \| plain처럼 백슬래시로 이스케이프할 수 있습니다. 표 안의 콘텐츠 서식 지정을 참조하세요.

여러 줄 셀이 지원되지 않을 때는 무엇을 사용해야 하나요?

대상에서 표는 지원하지만 인라인 HTML을 거부하면 상세 항목마다 행을 하나씩 사용하세요. 항목 이름을 반복하면 셀 안에서 줄을 바꾸지 않고도 연결 관계를 유지할 수 있습니다.

| Item | Detail |
| --- | --- |
| Notebook | Dotted pages |
| Notebook | Blue cover |

대상에서 핵심 CommonMark만 지원한다면 상세 정보를 제목과 목록으로 옮기세요.

### Notebook

- Dotted pages
- Blue cover

제목과 목록은 CommonMark 구문에 포함됩니다. 이 대안은 표 확장 기능에 의존하지 않고 긴 항목을 추가하기에도 적합합니다.

여러 줄 코드는 표 바깥에 펜스 코드 블록으로 배치하세요. 여러 소스 줄을 하나의 인라인 코드 구간으로 감싸도 줄 바꿈은 유지되지 않습니다. CommonMark는 코드 구간의 줄 끝을 공백으로 정규화합니다. 코드 구간을 참조하세요.

보존해야 하는 콘텐츠에 따라 형식을 선택하세요. 짧은 구문 두 개라면 인라인 줄 바꿈을 적용해 확인하는 것이 실용적입니다. 별도의 문단이나 긴 목록, 여러 줄 코드는 셀 밖으로 옮기세요. 작업 노트에 작은 호환성 샘플을 보관하면 대상이 바뀔 때마다 확인을 반복할 수 있습니다.

출처