Mac의 명령줄에서 Markdown을 PDF로.
무료 도구 marsdawn은 명령 하나로 Markdown 파일을 PDF로 바꿉니다. 표, 수식, Mermaid 다이어그램, 강조 표시된 코드가 원본에서 읽히는 그대로 나오며, 다른 것은 아무것도 설치할 필요가 없습니다. MarsDawn 앱조차 필요 없습니다.
설치하기
brew install redtear1115/tap/marsdawn
marsdawn --version
Apple 실리콘 Mac에서는 Homebrew가 미리 빌드된 사본을 몇 초 만에 설치합니다. Intel Mac에서는 대신 소스에서 빌드하므로 몇 분이 걸리고 Xcode 26 이상이 필요합니다. macOS 15 이상에서 실행되며, marsdawn --version으로 설치된 버전을 확인할 수 있습니다.
문서 저장하기
다음 내용을 plan.md라는 파일에 붙여 넣으세요.
# 계획: 더 빠른 내보내기
이 계획은 에이전트가 작성했습니다. 검토한 다음 PDF로 만드세요.
## 단계
| 단계 | 담당 | 상태 |
|------|------|------|
| 느린 페이지 측정 | 에이전트 | 완료 |
| 렌더링한 다이어그램 캐시 | 에이전트 | 검토 중 |
목표는 50페이지 문서를 $t < 2\,\text{s}$ 안에 처리하는 것입니다.
$$
t_{\text{total}} = \sum_{i=1}^{n} t_i
$$
```mermaid
graph LR
초안 --> 검토 --> 배포
```
```swift
let pdf = try export("plan.md")
```
내보내기
marsdawn export plan.md
원본 옆에 plan.pdf를 쓰고, 저장된 위치를 출력합니다.
Exported /Users/you/plan.pdf (1 page)
아래는 marsdawn 0.5.0을 실제로 실행해서 캡처한 바로 그 페이지입니다.

테마, 용지 크기, 파일 이름 선택하기
marsdawn export plan.md --theme classic --paper letter -o handout.pdf
--theme: dawn, classic, modern, vivid 중 하나이며, 테마의 라이트 색상을 사용합니다. 지정하지 않으면export는$MARSDAWN_THEME을, 그것도 없으면 dawn을 사용합니다.--paper: a4 또는 letter. 기본값은 a4입니다.-o: 원본 옆 대신 PDF를 쓸 위치입니다.--allow-remote-images: 렌더링하는 동안 웹에서 이미지를 불러옵니다. 이 옵션을 주지 않으면 꺼진 상태로 유지됩니다.
잘 안 될 때
A full installation of Xcode.app 26.0 is required to compile this software.Intel Mac에서처럼 Homebrew가marsdawn을 소스에서 빌드하고 있습니다. App Store에서 Xcode 26 이상을 설치한 다음 설치를 다시 실행하세요.marsdawn: No such file: …경로가 파일을 가리키지 않습니다. 이름을 확인하거나, 파일이 있는 폴더에서 명령을 실행하세요.… already exists. Pass --force to replace it.같은 이름의 PDF가 이미 있습니다. 바꾸려면--force를, 다른 곳에 쓰려면-o를 추가하세요.Error: The value '…' is invalid for '--theme <theme>'.알 수 없는 테마나 용지 크기입니다. 테마는 dawn, classic, modern, vivid이고, 용지는 a4 또는 letter입니다.
다음
- 모든 옵션과 출력되는 JSON: 명령줄.
- 코딩 에이전트가 이 일을 대신하게 하려면
marsdawn skill --install을 실행해 marsdawn 에이전트 스킬을 추가하세요. - 네 가지 미리보기 테마와 PDF 내보내기의 방향: 미리보기 테마와 PDF 내보내기.
- Markdown을 쓰지 않는 사람에게 PDF 전달하기: PDF 공유하기.