docmd

docmd의 실체

docmd(github.com/docmd-io/docmd)는 Markdown 폴더를 문서 사이트로 바꾸는 Node CLI입니다. `npx @docmd/core dev` 는 Markdown이 있는 폴더라면 어디서나 실행되어 설정 파일 없이, frontmatter 요구 없이, 디렉터리 구조에서 도출한 내비게이션과 함께 localhost로 서빙합니다. `npx @docmd/core build` 는 어디에나 호스팅할 수 있는 정적 사이트를 씁니다. 라이선스는 저장소 LICENSE 파일에 담긴 평범한 MIT이고, 프로젝트는 2025년 5월에 시작했으며, 릴리스 이력은 몰아치기가 아니라 꾸준한 편으로 2026년 7월 15일 0.8.15부터 2026년 8월 23일 0.9.4까지 이어졌고 수집 시점의 열린 이슈는 14개였습니다.

• 아무 설정 없이 시작한다 설정 파일이 전혀 필요하지 않습니다. 제목이나 정규 URL, 다른 입출력 디렉터리를 지정하고 싶을 때를 위해 `docmd.config.json` 이 있고, 동적인 값이 필요하면 TypeScript나 JavaScript로도 쓸 수 있습니다.
• AI용 산출물은 부가 기능이 아니라 코어 플러그인이다 `llms`, `okf`, `search`, `seo`, `sitemap` 플러그인이 기본으로 켜져 있습니다. 즉 컨텍스트 파일과 사이트맵은 누군가 기억해야 하는 별도 단계가 아니라 평범한 빌드의 결과로 나옵니다.
• 마이그레이션이 기본 포함되어 있다 `docmd migrate` 는 기존 Docusaurus, VitePress, MkDocs, Starlight 구성을 변환합니다. 중요한 것은 시험 삼아 써보는 일이 전면 재작성으로 시작하지 않는다는 점입니다.
• 다국어와 버전을 일급 빌드로 다룬다 다국어 빌드는 언어별 검색 인덱스, 언어별 컨텍스트 파일, hreflang 태그를 만들고 문서 버전 관리는 플러그인이 아니라 기본 기능입니다. 이미 사이트를 번역하고 있다면 채택 여부는 여기서 갈립니다.
• Node 버전은 README가 아니라 패키지에서 확인한다 README는 Node.js 18 이상이라고 적고 있지만, 배포된 `@docmd/core` 패키지는 `engines.node >= 20.0.0` 을 선언합니다. 아직 18을 쓰는 머신이라면 알려주는 쪽은 설치 과정이므로 20을 전제로 계획하세요.

호스팅되는 쪽도 있어서 도입 전에 경계가 어디인지 알아둘 가치가 있습니다. AI 어시스턴트 플러그인은 자체 API 키나 로컬 모델을 써서 자기 문서에 대한 검색 증강 대화를 합니다. cloud.docmd.io의 Cloud Relay는 순수 정적 사이트가 백엔드를 직접 띄우지 않고도 그 어시스턴트를 돌릴 수 있게 하려고 존재합니다. 컴파일러와 아래의 모든 산출물은 MIT 저장소 안에 있고, relay만이 선택적인 호스팅 편의 기능 — 즉 축소판 오픈 코어 구조입니다.

기계를 향한 네 가지 산출물과 각각의 소비자

이 목록이 보기보다 값진 이유가 있습니다. 우리는 AgentCeres — AI 그로스 오피서, agentceres.com — 를 위해 `llms.txt` 와 `llms-full.txt` 를 공개하는데, 둘 다 손으로 썼습니다. 그리고 내용이 어긋났습니다. 고객이 실제로는 선택할 수 없는 내부 역할이 실렸고, 우리가 한 번도 판 적 없는 좌석당 과금 요금표가 실려 있었습니다. 몇 주 동안 아무도 알아채지 못했습니다. 마케팅 문구를 지키는 검사들은 애플리케이션 소스 디렉터리를 훑는데, 이 두 파일은 정적 `public/` 폴더에 있고 그중 어느 검사도 그곳을 읽지 않기 때문입니다. 생성된 컨텍스트 파일은 이 부류의 실수를 구조적으로 통째로 없앱니다. 생성이 더 똑똑해서가 아니라, 낡아갈 두 번째 사본이 남지 않기 때문입니다.

발견되려 할 때 어디에 맞물리나

문서는 작은 팀이 쓰는 것 중 답변 엔진이 그대로 쓸 수 있는 몇 안 되는 재료입니다. 구체적이고, 날짜가 있고, 다른 누구도 그만큼 정확하게 쓸 수 없는 제품 설명이기 때문입니다. 그래서 생성 엔진 최적화의 원료로 훌륭하고, docmd는 그것을 검색 가능하게 만드는 비용을 사실상 0에 가깝게 낮춥니다. 질문이 더 넓게 ChatGPT가 내 스타트업을 인용하게 하는 법이라면, 이것은 그 문제의 입력 하나이지 답은 아닙니다.

한계도 분명히 해두어야 합니다. 과대평가하기 쉬운 지점이기 때문입니다. 컨텍스트 파일을 내보내면 문서 검색이 싸지지만, 모델이 당신을 고르게 만들지는 못하고 어떤 빌드 단계도 그렇게 할 수 없습니다. 게다가 대상은 문서뿐입니다. 가격 페이지, 비교 페이지, 랜딩 페이지는 다른 문제를 가진 다른 말뭉치이고, 구매자의 질문이 실제로 착지하는 곳은 대개 그쪽입니다. 필요한 것이 기계 판독용 절반이 아니라 문서 사이트 자체라면 Docusaurus가 더 무난한 선택이며 별도로 다루고 있습니다.

창업자에게 정직한 순서는 이렇습니다. 사용자가 필요로 하니까 문서를 쓰고, 컨텍스트 파일은 공짜 부산물로 챙기고, 유입은 몇 달이 걸릴 수도 있는 2차 효과로 취급하세요. 파일 공개는 빌드 플래그 하나입니다. 인용될 만한 내용인지가 진짜 일이고, 그 부분은 여전히 쓰는 일입니다. 바로 그 지점에서 AgentCeres가 당신 옆에서 초안을 쓰고, 밖으로 나가는 것은 사람이 승인합니다.