"글도 코드처럼 린트 돌린다"… 기술 문서 스타일 가이드 자동 검사기 'Vale'

요약 문서나 글을 쓸 때도 코드처럼 문법 오류와 맞춤법, 스타일 가이드를 자동으로 검사해 주는 오픈소스 산문 린팅(linting) 도구 'Vale'가 개발자들 사이에서 주목받고 있습니다. Vale는 단순한 맞춤법 검사기를 넘어, 팀이나 조직이 정한 고유의 스타일 가이드와 용어 표기 규칙을 YAML 파일 형식으로 정의하여 에디터 및 CI 파이프라인에서 자동으로 검사할 수 있도록 지원하는 CLI 기반 오픈소스 도구입니다. 이 도구의 가장 큰 특징은 글의 구조와 문맥을 인식한다는 점입니다. 일반 텍스트가 아닌 마크다운(Markdown), AsciiDoc, MDX, HTML 등 12가지 마크업 형식을 파싱하여 제목, 본문 문단, 리스트 셀 등만 골라 검사하며, 그 안에 포함된 코드 블록이나 링크 URL은 검사 대상에서 자동으로 제외합니다. 또한 트리시터(tree-sitter) 문법을 활용해 Go, Rust, Python, TypeScript 등 19개 프로그래밍 언어의 소스 코드 주석에 포함된 설명문까지 정확하게 추출해 스타일 규칙을 적용할 수 있습니다. 성능 측면에서도 별도의 무거운 런타임 없이 단일 Go 바이너리로 실행되며, 병렬 처리를 통해 깃랩(GitLab) 문서 기준 2,800페이지가 넘는 마크다운 분량에 82개 규칙을 적용해도 20초 이내에 검사를 마치는 빠른 속도를 자랑합니다. 현재 AWS, 마이크로소프트, 도커(Docker), 깃랩, 레드햇, 엔비디아, 데이터독(Datadog), 디스코드 등 글로벌 IT 기업들이 제품 공식 문서 및 오픈소스 프로젝트의 스타일 검사 도구로 도입해 활용 중입니다. VS Code, Cursor, Neovim, JetBrains, Obsidian 등 다양한 에디터와 플러그인 연동을 지원하며, 깃허브 스타 6천 개 이상, 누적 다운로드 1,390만 건을 기록하고 있습니다.