마크다운 가이드

자주 쓰는 마크다운 문법

# Document title

## Section

**Bold**, *italic*, and ~~removed~~.

- First item
- Second item

1. First step
2. Second step

- [x] Done
- [ ] Next task

| Feature | Status |
| --- | --- |
| Live preview | Ready |
| Local recovery | Ready |

[Example](https://example.com)

![Alt text](https://example.com/image.png)

Use `inline code`.

```js
const message = "Hello";
```

The area is $A = \pi r^2$.

$$
E = mc^2
$$

```mermaid
flowchart LR
  A[Write] --> B[Preview]
  B --> C[Save a file]
```

문서 열기와 파일 저장

파일 → 파일 열기를 선택하거나 .md, .markdown, .txt 파일을 작업 공간에 놓으세요. 파일마다 새 탭이 열리므로 현재 문서를 덮어쓰지 않습니다. 새 문서는 빈 상태로 시작합니다. 파일당 2 MiB 이하의 UTF-8 파일을 최대 20개 탭에서 사용할 수 있습니다.

브라우저가 지원하고 권한을 허용하면 저장 시 선택한 로컬 파일에 기록합니다. 그 외에는 마크다운 다운로드를 시작합니다. 다운로드 요청만으로 실제 디스크에 저장되었는지는 확인할 수 없습니다. 다른 이름으로 저장에서는 새 대상을 선택합니다. 새로고침 후 원본에 직접 저장하려면 파일을 다시 열어 연결하세요.

브라우저 복구본은 파일 백업과 다릅니다

자동 복구는 열린 문서와 탭 상태를 현재 브라우저에 저장합니다. 모든 언어의 화면은 같은 작업 공간을 사용합니다. 탭의 점은 마지막 파일 저장 또는 마크다운 다운로드 요청 이후의 변경을 뜻하며, 브라우저 복구 상태와는 다릅니다.

비공개 브라우징, 저장 공간 정리, 사이트 데이터 삭제로 복구본이 없어질 수 있습니다. 중요한 문서는 파일로 저장하세요. 수정한 탭을 닫을 때는 확인하며, 모든 문서 닫기를 확인하면 해당 복구본이 제거됩니다. 다른 브라우저 탭에서 수정한 내용은 자동으로 병합하지 않습니다.

편안한 편집 환경

두 번째 줄에서 분할 보기, 편집기만, 미리보기만 표시하도록 바꿀 수 있습니다. 미리보기는 에디터를 직접 스크롤할 때만 따라갑니다. 미리보기를 스크롤하거나 원문을 입력해도 다른 영역을 이동시키지 않습니다. 내용이 바뀌면 마크다운 블록을 찾아 읽던 위치를 보존하며, 크게 수정하거나 삭제한 부분은 가까운 남은 블록을 기준으로 복원합니다. 두 영역을 완전히 독립적으로 이동하려면 따라가기를 끄세요.

목차 버튼을 누르면 상시 사이드바 없이 문서 제목으로 이동할 수 있습니다. 설정 메뉴에서 시스템·라이트·다크 테마, 14~24px 편집기 글자 크기, 시스템 고정폭·산세리프 글꼴, 줄 번호와 렌더링 옵션을 고릅니다. 기존 글자 크기는 유지하며 새 환경의 기본값은 16px입니다. 예제 버튼에서는 문법과 템플릿을 검색해 복사하거나 삽입할 수 있습니다. 표 버튼에서 열과 행을 선택하며 행 개수에는 제목 행이 포함됩니다. Ctrl/Command + F로 원문을 검색하고, Tab 키로 편집기 밖으로 이동하며, 서식 버튼은 방향키로 이동합니다.

25만 UTF-16 코드 단위 또는 1만 줄바꿈을 넘는 문서는 타이핑 반응성을 위해 자동 미리보기를 멈춥니다. 미리보기 새로 고침 버튼으로 갱신할 수 있으며 편집과 마크다운 저장은 계속 사용할 수 있습니다.

수식

인라인 수식은 $...$ 또는 \(...\)를 사용합니다. 별도 줄에 표시하는 수식은 $$를 앞뒤 독립된 줄에 쓰거나 \[와 \]를 사용합니다. 백틱 안의 코드는 수식으로 처리하지 않습니다. 통화 기호와 혼동될 때는 \$처럼 이스케이프하세요.

로컬 KaTeX 렌더러는 LaTeX의 일부 문법을 지원하며 완전한 .tex 문서를 처리하지는 않습니다. 출력은 브라우저의 MathML을 사용합니다. 수식은 최대 100개, 수식당 4,000자까지 렌더링합니다. 지원하지 않거나 안전하지 않은 명령은 실행하거나 외부 리소스를 불러오는 대신 원문을 유지합니다.

Mermaid 다이어그램

mermaid로 표시한 코드 블록은 해당 설정이 켜져 있으면 로컬에서 렌더링합니다. 다이어그램을 클라우드 서비스로 보내지 않습니다. 렌더러는 네트워크와 저장소 접근이 차단된 별도 샌드박스에서 실행합니다.

문서당 최대 24개, 다이어그램당 12,000자까지 렌더링 대상이 됩니다. 연결선 200개 제한과 처리 시간 제한도 적용합니다. 다이어그램 내부의 설정 지시문과 YAML 설정 머리말은 허용하지 않습니다. 잘못되었거나 지원하지 않는 다이어그램은 원문으로 남깁니다.

다른 앱으로 내용 옮기기

마크다운 복사는 원문을, HTML 복사는 수식과 다이어그램을 원문으로 유지한 HTML 마크업을 복사합니다. 서식 유지 복사는 HTML과 일반 텍스트를 함께 제공하여 지원 앱에서 제목, 강조, 목록과 표를 붙여넣을 수 있습니다. 실제 서식은 받는 앱에 따라 달라지며 수식과 다이어그램은 클립보드 호환성을 위해 원문으로 남습니다.

HTML 내보내기는 렌더링에 성공한 MathML 수식과 정화된 다이어그램 이미지를 포함하는 독립 문서를 만듭니다. IT Drawer 스크립트 없이 열 수 있습니다. 인쇄 / PDF로 저장은 브라우저 인쇄 창을 사용하며 PDF 저장 지원은 운영체제에 따라 다릅니다. 외부 마크다운 이미지는 해당 문서에서 명시적으로 허용하기 전까지 차단합니다.

오프라인 사용과 설치

온라인 상태에서 파일 → 오프라인 및 설치 → 오프라인 사용 켜기를 선택하세요. 두 언어의 에디터 화면과 렌더링 라이브러리를 준비합니다. 오프라인 파일은 문서 복구본과 별도입니다. 브라우저의 앱 설치 또는 홈 화면에 추가는 선택 사항입니다.

오프라인 사용이 준비되었다는 상태를 확인한 후 연결을 끊으세요. 마크다운 작업 공간은 오프라인으로 사용할 수 있지만 외부 이미지, 이 가이드와 다른 IT Drawer 도구는 포함하지 않습니다. 브라우저 저장소는 영구적이지 않습니다. 업데이트는 에디터 창을 닫을 때까지 기다리며 작업 중인 문서를 강제로 새로고침하지 않습니다.

오프라인 캐시 제거는 마크다운 전용 워커와 앱 캐시만 제거하며 복구 문서는 유지합니다. 제거 후 에디터 창을 모두 닫으세요. 문서까지 지우려면 에디터에서 문서를 닫거나 브라우저의 사이트 데이터를 지우세요.