--- title: 문서를 자산으로 만드는 팀 핸드북 description: 입력부터 재사용까지 이어지는 문서 운영 원칙과 실행 예제 author: Glif Guide Team date: 2026-08-01 tags: - handbook - publishing - reuse --- # 문서를 자산으로 만드는 팀 핸드북 문서는 한 번 읽고 버리는 파일이 아니라, 다음 입력과 여러 출력으로 계속 이어지는 자산이다. 이 핸드북은 다양한 문서와 에셋을 Markdown으로 모으고, 목적에 맞는 보기와 출판물로 다시 사용하는 최소 운영 규칙을 설명한다. > 원본은 단순하게 유지하고 표현과 전달 방식은 필요에 따라 확장한다. ## 1. 입력을 한곳에 모으기 회의 메모, 조사 결과, 표, 이미지와 외부 링크를 하나의 Scope에 모은다. 파일 형식이 서로 달라도 변환 뒤의 기준 원문은 읽을 수 있는 Markdown으로 유지한다. ### 수집 체크리스트 - [x] 문서 제목과 목적을 적는다. - [x] 출처 링크와 작성일을 남긴다. - [ ] 재사용할 이미지에 대체 텍스트를 추가한다. - [ ] 공개 전에 개인정보와 비공개 경로를 점검한다. ## 2. 원문과 표현을 분리하기 같은 Markdown을 Page, Kanban, Timeline, Chart와 PDF로 다르게 읽을 수 있다. 보기 설정은 원문 내용을 대신하지 않는다. PDF 확대율도 화면에서 읽기 편한 크기만 바꾸며 문서 내용이나 최종 용지 크기를 바꾸지 않는다. | 계층 | 소유하는 것 | 바꾸지 않는 것 | | :--- | :--- | :--- | | Markdown | 제목, 문단, 목록, 표, 링크 | 보기 확대율 | | Projection | 해석 방식과 화면 표현 | 원문 의미 | | PDF 템플릿 | 표지, 목차, 여백, 본문 조판 | Markdown source | | 출력 실행 | 대상 문서, 파일명, 생성 후 열기 | 저장된 템플릿 | ## 3. 검토 가능한 단위로 쪼개기 큰 문서는 작은 heading과 표로 나눈다. 독자는 목차로 이동하고, 작성자는 section 단위로 수정하며, PDF 출력은 같은 heading 구조를 본문 계층으로 사용한다. ### 권장 검토 순서 1. 목적과 독자를 확인한다. 2. 제목과 heading 계층을 읽는다. 3. 표의 수치와 출처를 대조한다. 4. 링크와 포함된 에셋을 확인한다. 5. Desktop 미리보기와 최종 PDF를 각각 확인한다. ## 4. 출판 전 점검표 | 점검 항목 | 담당 | 상태 | 증거 | | :--- | :--- | :---: | :--- | | 원문 구조 | 작성자 | 완료 | heading과 목록 | | 링크 유효성 | 검토자 | 진행 | 링크 상태 보고서 | | 표지와 목차 | 편집자 | 완료 | PDF 미리보기 | | 최종 파일 | 배포자 | 대기 | 저장된 PDF | ## 5. 실패해도 원문을 보존하기 PDF 생성이 실패하면 원인을 확인하고 다시 시도한다. 미리보기 오류 때문에 Markdown을 빈 문서로 덮어쓰거나 템플릿을 자동으로 다른 값에 연결하지 않는다. 마지막으로 성공한 미리보기가 있다면 오류 상태와 함께 구분해 보여야 한다. ```text source Markdown → template resolution → preview artifact → final PDF │ │ │ └──── 원문 보존 ───┴──── 재시도 가능 ──┘ ``` ## 6. 출력물을 다시 입력으로 사용하기 출판된 PDF는 검토와 공유에 쓰고, 수정 사항은 다시 Markdown 원문에 반영한다. 화면에서 확대해 읽은 상태나 PDF viewer의 임시 조작은 원문으로 역기록하지 않는다. ### 완료 기준 - 표지에서 현재 출력 소스의 제목을 식별할 수 있다. - 본문 heading, 표, 목록과 인용이 잘리지 않는다. - 90%와 110% 확대에서 원문 byte가 같다. - 대화상자의 이번 출력 옵션과 저장된 템플릿 설정을 구분한다. - 최종 저장 파일을 별도 PDF reader에서 다시 연다.