# Markdown을 Typst로

Markdown 노트를 Typst 소스로 변환해 빠른 로컬 글쓰기 프로젝트에서 엽니다.

Markdown을 Typst로 도구는 Markdown의 쉬운 시작을 유지하면서, 초안이 준비되면 더 표현력 있는 조판 시스템을 얹어 줍니다. 흔한 구조와 수식이 그대로 넘어가고, 결과는 다시 다듬을 수 있는 일반 소스로 남습니다.

## 이럴 때 쓰세요

- 보고서, 유인물, 논문으로 커진 노트
- 더 나은 페이지 디자인이 필요한 Markdown 초안
- 내용을 다시 입력하지 않고 Typst를 써 보고 싶을 때

새롭다는 이유만으로 변환하지는 마세요. 저장소, 정적 사이트, 협업자가 Markdown을 기대한다면 그 이식성이 추가 레이아웃 제어보다 더 값질 수 있습니다.

## 소스 변환하기

1. **Markdown을 Typst로**를 열거나 `/markdown-to-typst` 명령을 실행하세요.
2. Markdown을 붙여 넣으세요.
3. **변환**을 선택하세요.
4. 생성된 Typst를 살펴보세요.
5. 복사하거나, `converted.typ` 파일로 저장하거나, Typst 프로젝트를 만드세요.

예를 들어 Markdown 제목, 굵은 글씨, 번호 목록, 달러 기호로 감싼 수식은 대응하는 Typst 요소로 바뀝니다. 변환은 내장 Pandoc으로 이 컴퓨터에서 실행됩니다.

## 변환 후 손볼 부분

Markdown에는 방언이 많습니다. 할 일 목록, 원시 HTML, 사용자 정의 지시문, 인용 확장, 플러그인 구문은 넘어가지 않을 수 있습니다. Typst에서도 템플릿, 참고문헌 스타일, 페이지 설정, 재사용 함수를 따로 정해야 합니다.

새 프로젝트를 컴파일하고 다음을 확인하세요.

- 제목 계층과 목록 중첩
- 수식과 코드 블록
- 링크와 이미지 경로
- 각주와 인용
- Markdown 핵심 형식에 속하지 않는 모든 확장

LaTeX로 투고한다면 [Markdown을 LaTeX로](/docs/tools/markdown-to-latex/)를 바로 쓰세요. 반대 방향에는 [Typst를 Markdown으로](/docs/tools/typst-to-markdown/)를 쓰세요. 빈 Typst 작업 공간은 [비주얼 Typst 편집기](/docs/tools/visual-typst-editor/)나 [Typst 편집기](/docs/tools/typst-editor/)로 시작하세요.