Agent Tool

문서를 섹션 단위로 접근하여
토큰을 90% 절감

markdownai는 AI 에이전트가 마크다운 문서의 정확히 필요한 섹션만 읽고, 검색하고, 수정하도록 설계된 오픈소스 CLI입니다.

데모 보기 GitHub
Problem

기존 방식의 문제

AI 에이전트가 문서를 읽을 때, 수백 페이지의 나이지 지식 베이스에서 한 섹션만 필요해도 파일 전체를 읽어야 합니다.

Obsidian 볼트, 문서 리포지토리, 위키 등 대규모 마크다운 컬렉션에서 이 비효율은 기하급수적으로 증가합니다.

90% 읽어들인 문서 중 실제 사용하지 않는 비율
기존 방식
README.md (320 lines)
1
2
3
4
5
6
7
8
9
10
11
12
markdownai
## Setup > ### Prerequisites
5
6
7
8
8,200 tokens
전체 문서 로드
820
섹션 단위 로드
섹션 단위 인덱싱
문서의 헤더 구조를 분석하여 모든 섹션에 즉시 접근할 수 있는 주소를 자동 생성합니다.
# 섹션 주소 지정 방식
#1.2 → TOC 인덱스
## Setup > ### Prerequisites → 헤더 경로
L10-L25 → 라인 범위
전문 검색
파일명, 섹션, 라인 위치까지 정확한 검색 결과를 제공합니다.
$ markdownai search "prerequisites"
# README.md > ## Setup > ### Prerequisites (L10-L25)
정밀 수정
문서의 나머지를 건드리지 않고 특정 섹션만 교체, 추가, 삭제합니다.
read #1.2 → edit #1.2 → verify
Solution

markdownai의 접근

markdownai는 마크다운 문서를 섹션 단위로 접근합니다. 수백 페이지 문서에서도 필요한 섹션만 바로 꺼내 읽을 수 있어, 불필요한 토큰 소비를 원천 차단합니다.

강력한 전문 검색이 파일과 섹션 위치까지 정확히 찾아주고, 인덱스가 자동 동기화되어 반복 조회 비용이 제로입니다.

90% 토큰 절감 달성
Demo

실제 동작 모습

Features

주요 기능

섹션 레벨 주소 지정

다양한 방식으로 원하는 섹션에 바로 접근하여 문서 전체를 읽을 필요가 없습니다.

전문 검색

파일명, 섹션, 라인 위치까지 정확한 검색 결과를 제공하여 원하는 정보를 즉시 찾습니다.

정밀 수정

문서의 나머지를 건드리지 않고 특정 섹션만 교체, 추가, 삭제할 수 있습니다.

즉시 재조회

인덱스가 파일 변경을 자동 감지하여 항상 최신 상태를 유지합니다. 반복 조회 비용이 제로입니다.

링크 그래프

문서 간 링크 관계를 추적하고 끊어진 링크를 감지하여 문서 품질을 유지합니다.

Quick Start

시작하기

한 줄의 명령으로 설치가 완료됩니다.

$ curl -fsSL https://raw.githubusercontent.com/worktoolai/markdownai/main/install.sh | sh