언어¶
한 줄 = 한 블록¶
마크다운 한 줄이 노션 블록 하나가 된다. 문단을 합치지 않는다. 블록 안 줄바꿈은 <br>로 쓴다.
지시자¶
노션에만 있는 구조는 <!--@ … --> 주석으로 덧댄다. 뷰어에서는 보이지 않는다.
| 지시자 | 짝 | 붙는 곳 |
|---|---|---|
<!--@ empty --> |
— | 빈 문단 |
<!--@ table header=row |
— | 다음 표 |
<!--@ image kind=graph |
— | 다음 그림 |
<!--@ callout icon=💡 |
— | 다음 한 블록 |
<!--@ toggle icon=… … <!--@ /toggle --> |
쌍 | 첫 자식이 제목 |
<!--@ columns n=2 … <!--@ /columns --> |
쌍 | column 목록 |
<!--@ block … <!--@ /block --> |
쌍 | 블록 경계 표시(자체 블록 없음) |
<!--@ keep text=… |
— | 로컬 전용(노션에 안 보냄) |
블록 경계 표시¶
묶음이 애매할 때만 <!--@ block -->으로 감싼다. 자체 블록을 만들지 않고 안쪽 블록을 그대로 낸다.
태그는 쓰지 않는다
<nl-block> 같은 태그는 CommonMark가 HTML 블록으로 판정해 안쪽 표·목록이 렌더되지 않는다. 주석 펜스를 쓴다.
표¶
- 행 단위로 반영된다. 바뀐 행만 고치고, 늘면 추가하고, 줄면 (댓글 0 확인 후) 삭제한다.
- 열 수 변경은 표 재생성이 필요해 막는다.
그림¶
- 비교는 캡션만 한다(로컬 경로와 노션 첨부는 다르다).
- 파일 업로드는 아직 구현되지 않았다. 원격 URL 그림은 그대로 둔다.
수식¶
인라인은 $…$, 블록은 $$ 펜스.