Blume 2.0
Hayden Bleasel · 글쓰기 · 코딩
Blume 2.0은 오픈소스 문서 프레임워크다. Markdown 폴더를 빠른 Astro 사이트로 바꾸고, 로컬 검색과 API 레퍼런스, 코딩 에이전트용 MCP 서버를 함께 제공한다.
Blume 2.0 소개
About
Blume 2.0이란
Blume 2.0은 Astro와 Vite 위에 올린 문서 프레임워크다. Markdown이나 MDX 파일을 docs/ 폴더에 넣고 명령을 한 번 실행하면 내비게이션, 검색, 구문 강조, Open Graph 이미지까지 붙은 사이트가 나온다. 관리할 애플리케이션 코드도 없고, 아침마다 로그인할 대시보드도 없다.
두 번째 메이저 버전이 바꾼 것은 주로 설정이다. 검색, 배포, 콘텐츠 소스, API 레퍼런스, 분석, 어시스턴트 백엔드가 blume/* 하위 경로에서 가져와 blume.config.ts에서 호출하는 어댑터가 됐다. 기계가 읽는 설정은 ai에서 새 agents 키로 옮겼다. 페이지는 건드릴 필요가 없어서, 업그레이드는 설정 작업이지 재작성이 아니다.
다른 정적 생성기와 갈리는 지점은 두 번째 독자다. 모든 사이트가 llms.txt, 페이지별 Markdown 미러, 읽기 전용 JSON 문서 API를 내보내고, 원하면 MCP 서버도 띄운다. 에이전트는 사람이 읽는 것과 같은 내용을 읽는다. 이 묶음이 있어야 Markdown 문서 사이트가 AI 에이전트용 문서가 된다. 대가도 분명하다. 개발자 도구이고, 호스팅 에디터와 위지윅 패널을 기대하면 Git 저장소가 기다린다.
시작하기
- 빈 폴더에서
npx blume init을 실행한다. CLI가 의존성을 설치하고package.json에dev와build스크립트를 추가한다. blume.config.ts를 열고 사이트 이름, URL, 필요한 검색·배포·분석 어댑터를 적는다.- Markdown 파일을
docs/에 넣는다. 폴더 구조가 URL 경로가 되고, 페이지 순서는 파일 이름이나meta.ts에서 나온다. npm run dev로 로컬에서 확인하고npm run build로 정적 파일을 뽑는다.- 선택 사항으로
npx blume migrate <원본> --codex를 쓰면 Mintlify, Docusaurus, GitBook, MkDocs 사이트 변환을 코딩 에이전트에 맡긴다.
제품 정보
Blume 2.0의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 자사 제품 문서를 쓰는 개발자
- 플랫폼 팀과 API 팀
- 오픈소스 프로젝트 메인테이너
작업
- Markdown으로 기술 문서 발행
- 코딩 에이전트가 읽게 만들기
- 다른 플랫폼에서 이전
활용 상황
- 스타트업에서 README로는 부족해질 때
- 제품을 여러 언어로 낼 때
- 지원팀이 매주 같은 질문을 받을 때
주요 기능
Markdown 페이지와 자동으로 짜이는 내비게이션
폴더가 경로가 되고 파일 이름이 slug가 된다. 새 페이지는 새 파일이다. 사이드바는 디렉터리 트리에서 스스로 만들어지고, 그다음 frontmatter나 페이지 옆 meta.ts로 손을 본다. 그룹 순서를 바꾸거나 아이콘을 넣거나 페이지를 숨기는 일에 설정 파일을 열 필요가 없고, 빵부스러기와 오른쪽 목차도 같은 구조를 따른다.
llms.txt와 MCP를 갖춘 에이전트 표면
Blume 사이트는 llms.txt와 경로별 .md 미러를 공개한다. 에이전트는 렌더링된 HTML을 긁지 않고 페이지 원문을 가져간다. 선택형 MCP 서버는 검색과 페이지 읽기를 도구로 노출하고, 사이트는 OpenAPI 3.1 문서로 설명되는 JSON 문서 API도 제공한다. /.well-known/ai-catalog.json 매니페스트가 있으면 에이전트 레지스트리가 사이트를 찾아낸다.
명세에서 만드는 API 레퍼런스
Blume은 API 레퍼런스 생성기로 동작한다. OpenAPI, AsyncAPI, GraphQL 스키마를 로컬이나 원격에서 지정한다. 설정을 명세 파일로 돌리면 개요, 오퍼레이션별 페이지, 파라미터, 요청 본문, 응답 표가 나온다. 코드 샘플은 cURL과 Python부터 Go, Ruby, C#까지 18개 언어를 지원한다. 레퍼런스는 빌드 시점에 만들어지므로 스키마 변경은 다음 배포에 반영된다.
로컬 검색과 페이지 안 어시스턴트
검색은 로컬 인덱스로 돌아가고 API 키가 필요 없다. 공백으로 단어를 나누지 않는 중국어, 일본어, 한국어, 태국어도 찾는다. 사이트가 커지면 어댑터로 Algolia, Typesense, Orama Cloud, Mixedbread, Pagefind로 갈아탈 수 있다. 어시스턴트 패널은 사이트 자체 페이지에서 답하며, Vercel AI Gateway, OpenRouter, LLM Gateway, Inkeep, OpenAI 호환 엔드포인트를 붙일 수 있다.
번역과 버전이 붙은 문서
로케일 폴더는 언어 접두사가 붙은 경로, 언어별 내비게이션, 번역된 UI 문구를 만들고 blume translate가 빠진 언어를 채운다. 버전 기능은 릴리스마다 스냅숏 폴더를 고정하고 전환 UI를 붙이며 검색을 선택한 버전으로 제한한다. 두 기능 모두 에이전트 표면에 적용되므로, 에이전트는 독자와 같은 경로를 본다.
검사, 감사, Astro로 나가기
blume validate는 배포 전에 링크, 앵커, frontmatter를 검사한다. blume audit는 빌드된 HTML을 읽고 SEO 문제를 원본 파일과 줄 번호로 알려준다. blume eval은 읽는 에이전트와 심사 에이전트를 문서에 투입해 답을 실제로 찾을 수 있는지 시험한다. 프레임워크가 좁아지면 blume eject가 숨은 프로젝트를 내가 소유한 독립 Astro 앱으로 바꾼다.
장단점
장점
- MIT 라이선스라 편집자, 페이지, 트래픽에 제한이 없다. 비용은 호스팅과 직접 고른 모델의 토큰뿐이다.
- 설정 없이 시작한다. `npx blume init`은 config를 한 줄도 쓰기 전에 검색, 내비게이션, OG 이미지가 붙은 사이트를 내놓는다.
- 에이전트 표면이 나중에 덧붙인 기능이 아니라 기본 제공이라, 요즘 거의 모든 문서팀이 떠안는 `llms.txt`와 MCP 작업을 던다.
- 어댑터가 번거로운 선택을 대신 처리한다. Algolia, Typesense부터 Vercel, Netlify, Cloudflare, PostHog, Plausible까지 있다.
- CLI 검사와 `eject`라는 출구가 있어서 프레임워크 선택이 잠금이 되지 않는다.
단점
- Blume 2.0은 설정을 깨는 변경이다. 검색, 배포, 소스, 어시스턴트를 설정하던 프로젝트는 그 블록을 어댑터 호출로 다시 써야 하고, 설정이 크면 반나절이 걸린다.
- 호스팅 에디터와 대시보드가 없다. Git에 익숙하지 않은 작성자는 개발자나 CMS 소스에 기대야 하고, 마케팅팀에는 실제 비용이다.
- Node.js 22.19 이상이 필요하다. 오래된 CI 이미지는 런타임을 올리기 전까지 실패한다.
- AI 기능 요금은 모델 제공자에 직접 나간다. 프레임워크는 무료지만 어시스턴트 사용량이 많거나 나레이션을 만들면 매달 변동비가 붙는다.
자주 묻는 질문
Blume 2.0은 오픈소스 Astro 문서 프레임워크의 두 번째 메이저 버전이다. Markdown이나 MDX 파일로 사이트를 만들고 검색, API 레퍼런스, 번역, 버전 관리, 에이전트가 읽는 표면을 더한다.
관련 콘텐츠
Blume 2.0와 관련된 도구, 스킬, 아티클을 살펴보세요.
Blume 2.0 대안
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
MePersona
MePersona, Inc. · 글쓰기 · 생산성 · 마케팅MePersona는 크리에이터를 위한 AI 통합 받은편지함이다. 사용자의 말투를 학습해 12개 플랫폼의 팬 메시지 답장을 초안으로 쓰고, 승인한 것만 전송한다.
Fluence
Yay Software (Yannick Huchard) · 글쓰기 · 음성 및 언어 · 생산성Fluence는 Android용 문서 리더다. PDF, EPUB, Word 파일과 웹 글을 소리 내어 읽고, 읽는 문장을 화면에서 따라가며, 본문에 대한 질문에 기기 안에서 답한다.