마크다운으로 기술 문서를 작성한다면, 이미 그 긴장감을 알고 있을 것입니다. 문서의 일부는 직접 작성한 산문이고, 다른 일부는 목차, 포함된 코드 조각, 렌더링된 다이어그램과 같이 다른 곳에서 생성된 것입니다. 이 경계를 어떻게 처리하느냐에 따라 워크플로우에 대해 많은 것을 알 수 있습니다. 대부분의 문서 도구 체인은 PET 또는 Jamal과 같은 전처리기와 동일한 방식으로 이를 해결합니다. 즉, 소스와 출력을 분리합니다. 템플릿 파일을 유지하고 빌드 단계를 실행하면 결과로 렌더링된 문서가 생성됩니다. 깔끔하고 예측 가능하며 이해하기 쉽지만, 빌드 단계가 추가되고 출력 파일은 실제로 편집하거나 공유하는 파일이 아닙니다.