Markdown 말고 PDF를 건네세요.

에이전트가 문서를 끝내고, 여러분이 검토하고 고친 다음, 엔지니어링 밖의 누군가도 읽어야 할 때가 있습니다. 관리자, 고객, 다른 팀 사람 같은 경우입니다. 그들은 ##이나 세로 막대로 만든 표가 무슨 뜻인지 알 필요가 없습니다. PDF로 내보내서 그것을 건네세요.

검토를 마친 문서를 PDF로 내보내고 그 파일을 보내세요. 어디서든 열리고, Markdown 지식도 설치도 필요 없으며, 다이어그램, 표, 서식까지 미리보기에서 본 모습 그대로입니다.

.md 파일을 그냥 보내면 안 되는 이유

원본 .md 파일을 일반 텍스트 편집기로 열면 페이지가 아니라 기호가 보입니다. 제목을 뜻하는 #, 굵은 글씨를 감싼 **, 그려지지 않은 Mermaid 다이어그램의 코드 블록. Markdown을 쓰지 않는 사람은 이 중 어느 것도 의도대로 읽지 못하며, 문서 하나 때문에 뷰어부터 설치해 달라고 하기는 무리입니다.

스크린샷이 아닌 이유

스크린샷은 여러 페이지일 수 있는 문서를 한 화면 분량으로 굳혀 버리고, 검색이나 선택도 안 되며, 몇 번 압축되고 전달되면 더 읽기 어려워집니다. PDF는 길이와 상관없이 텍스트, 다이어그램, 페이지 나눔을 그대로 지킵니다.

PDF로 얻는 것

받는 사람이 이미 가진 것, 미리보기, 브라우저, Acrobat, 휴대폰에서 열립니다. Markdown 도구는 필요 없습니다.
Mermaid 다이어그램은 코드로 남지 않고 그려져 있으며, 코드 블록은 강조 표시를 유지합니다.
페이지 나눔은 제목이 페이지 맨 아래에 홀로 남지 않도록, 다이어그램이 두 페이지로 갈라지지 않도록 정해집니다.
MarsDawn 앱에서 만들든 무료 명령줄에서 만들든 같은 파일입니다. 단계별 안내는 Markdown을 PDF로를 참고하세요.

내보내기에 쓸 수 있는 테마와 레이아웃: 미리보기 테마와 PDF 내보내기.
앱 대신 스크립트나 에이전트에서 내보내기: 에이전트를 위한 marsdawn.
사람이 먼저 문서를 읽어야 하는 이유: 검토가 필요한 이유.
여러 에이전트 사이의 인수인계는 공유할 PDF가 자연스럽게 생기는 곳입니다: 네 가지 에이전트 설계 패턴과 각각이 건네는 문서.