블로그

공무원 버전 관리의 고통

'보고서_수정_최종_진짜최종_2.hwp'를 아직도 만들고 계신가요? 마크다운 기반 문서 관리로 파일명 지옥에서 벗어나는 방법을 알려드립니다.

마크다움 팀

이 파일명, 익숙하시죠?

📁 2026년 예산안 폴더
├── 예산안_초안.hwp
├── 예산안_수정.hwp
├── 예산안_수정2.hwp
├── 예산안_과장검토.hwp
├── 예산안_과장검토_수정.hwp
├── 예산안_최종.hwp
├── 예산안_최종_수정.hwp
├── 예산안_진짜최종.hwp
├── 예산안_진짜최종_v2.hwp
└── 예산안_진짜최종_v2_이거맞음.hwp

웃으셨나요? 하지만 누구나 한 번쯤은 이런 폴더를 만들어본 경험이 있을 겁니다. 이것은 개인의 습관 문제가 아닙니다. 도구의 한계에서 비롯되는 구조적인 문제입니다.

왜 이런 파일명이 생기나

바이너리 파일의 한계

HWP 파일은 바이너리(이진) 파일입니다. 바이너리 파일은 컴퓨터가 읽는 형식이기 때문에, 파일 안에서 "무엇이 바뀌었는지"를 사람이 확인할 수 없습니다.

예를 들어, "예산안_과장검토.hwp"와 "예산안_과장검토_수정.hwp" 사이에 어떤 변경이 있었는지 알려면:

  1. 두 파일을 각각 열어야 합니다
  2. 양쪽 문서를 나란히 놓고 눈으로 비교해야 합니다
  3. 변경 사항을 수동으로 찾아야 합니다

이것이 반복되면, 자연스럽게 파일명으로 버전을 구분하게 됩니다. "최종", "진짜최종", "v2", "이거맞음" — 모두 도구가 버전 관리를 해주지 못하기 때문에 사람이 직접 파일명으로 기록하는 것입니다.

이메일 첨부의 악순환

문제는 여기서 끝나지 않습니다. 이 파일을 이메일로 공유하면:

  • 동료 A가 "예산안_최종.hwp"를 받아 수정 → "예산안_최종_A수정.hwp" 생성
  • 동료 B도 같은 파일을 받아 수정 → "예산안_최종_B의견.hwp" 생성
  • 두 수정본을 합치려면 → 수작업으로 비교·병합 필요
  • 결과: "예산안_최종_AB병합_확정.hwp" 탄생

이 과정에서 누군가의 수정이 누락되거나, 잘못된 버전이 최종본으로 결재될 위험이 항상 존재합니다.

텍스트 파일은 다릅니다

마크다운 파일은 텍스트(plain text) 파일입니다. 텍스트 파일은 바이너리와 근본적으로 다른 특성이 있습니다:

특성 바이너리 (HWP) 텍스트 (마크다운)
변경 사항 비교 불가능 (파일 전체가 다르게 보임) 줄 단위로 정확히 비교 가능
변경 이력 추적 파일명에 의존 자동 기록 가능
병합 수동 (눈으로 비교) 자동 병합 가능
파일 크기 큼 (서식 포함) 작음 (텍스트만)

텍스트 파일의 가장 큰 장점은 변경 사항을 줄 단위로 비교할 수 있다는 것입니다. 예를 들어:

변경 전: - 소요 예산: 5,000만 원
변경 후: - 소요 예산: 7,500만 원
         ^^^^^^^^^^^
         이 부분이 변경됨

이런 비교가 자동으로 이루어지기 때문에, 파일명으로 버전을 구분할 필요가 없습니다. 파일은 하나, 이력은 자동입니다.

Git을 몰라도 되는 버전 관리

"그거 개발자들이 쓰는 Git이라는 거 아닌가요?" 맞습니다. Git은 개발자의 버전 관리 도구입니다. 하지만 마크다운 파일의 버전 관리를 위해 Git을 배울 필요는 없습니다.

방법 1: 파일 하나로 관리하기

마크다운 파일은 메모장에서도 열 수 있습니다. 파일을 수정할 때마다 날짜와 변경 내용을 문서 상단에 기록하면, 가장 단순한 형태의 버전 관리가 됩니다:

# 2026년 예산안

> **변경 이력**
> - 2026-04-15: 소요 예산 5,000만 → 7,500만 (과장 검토 반영)
> - 2026-04-10: 추진 일정 조정 (2분기 → 3분기)
> - 2026-04-01: 초안 작성

## 1. 추진 배경
...

방법 2: 마크다움에서 자동으로

마크다움은 로컬 파일 시스템에 마크다운 파일을 저장합니다. 파일 하나에 문서 하나. 수정할 때마다 같은 파일이 업데이트됩니다. "최종", "진짜최종"을 만들 이유가 없습니다.

데스크톱 앱에서는 운영체제의 파일 이력 기능(macOS의 Time Machine, Windows의 파일 기록)과 자연스럽게 연동됩니다. 별도의 도구를 배울 필요 없이, 과거 버전으로 돌아갈 수 있습니다.

방법 3: (고급) Git으로 완벽한 이력 관리

IT에 관심이 있는 분이라면, Git을 활용하면 더 강력한 버전 관리가 가능합니다. 누가, 언제, 어떤 줄을 수정했는지 완벽하게 추적됩니다. 이것은 투명성과 책임성이 중요한 공문서에 특히 유용합니다.

하지만 이것은 선택 사항입니다. Git을 몰라도 마크다운 기반 문서 관리의 이점은 충분합니다.

오늘부터 시작하는 방법

"최종_진짜최종" 지옥에서 벗어나는 가장 쉬운 방법은, 다음에 작성하는 문서 하나를 마크다운으로 써보는 것입니다.

  1. 마크다움 웹 에디터에 접속합니다 (설치 불필요)
  2. 공문서 템플릿 중 하나를 선택합니다
  3. 내용을 채우고 파일로 저장합니다
  4. 수정할 때는 같은 파일을 열어 수정합니다

파일은 하나, 이름도 바뀌지 않습니다. "예산안.md" — 이것이 처음이자 마지막 파일명입니다.

"최종"이라는 단어를 파일명에 쓰는 순간, 그것은 최종이 아닙니다. 진짜 최종은 버전 관리 시스템이 기억합니다.