Repolode
harehare

harehare/mq

Markdown 파일을 선택·필터링·변환하는 jq 스타일 명령줄 도구이자 쿼리 언어입니다.

스타
1,065
포크
24
열린 이슈
11
마지막 커밋
2시간 전

어떤 프로젝트인가요?

mq를 사용하면 jq로 JSON을 다루듯 Markdown을 쿼리하고 변환할 수 있습니다. 짧은 표현식으로 제목, 코드 블록, 링크, 표, 섹션 같은 문서 일부를 선택한 뒤, 명령줄에서 필터링하거나 매핑하고 다시 작성할 수 있습니다. Rust로 작성되었으며 REPL, 에디터용 언어 서버, 디버거가 함께 제공됩니다.

Markdown 외에도 HTML, CSV, JSON, YAML, TOML, XML 등 여러 입력 형식을 읽어 Markdown 표나 다른 출력 형식으로 변환할 수 있습니다. 쿼리는 모듈로 재사용할 수 있으며, mq-*라는 이름의 외부 서브커맨드를 CLI에 추가할 수도 있습니다. 샌드박스 플래그를 사용해 쿼리의 파일 읽기·쓰기, 네트워크 요청, 명령 실행을 제어합니다.

Node.js, WebAssembly, C 및 여러 언어용 바인딩과 VS Code, Neovim, Zed, JetBrains IDE용 에디터 확장도 제공합니다.

핵심 기능

  • 01jq 스타일 표현식으로 제목, 코드 블록, 링크, 표, 섹션을 선택합니다.
  • 02내장 함수와 선택자를 사용해 Markdown 콘텐츠를 필터링하고 매핑합니다.
  • 03HTML, CSV, JSON, YAML, TOML, XML을 입력으로 읽고 여러 형식으로 출력합니다.
  • 04대화형 REPL, 언어 서버, 실험적인 디버거를 제공합니다.
  • 05파일, 네트워크, 명령어 접근 권한을 명시적으로 허용하는 샌드박스에서 쿼리를 실행합니다.

활용 사례

  • 대규모 문서 모음에서 특정 섹션이나 코드 조각을 추출합니다.
  • LLM 워크플로에 사용할 Markdown 프롬프트와 출력을 준비하거나 정리합니다.
  • 저장소의 여러 Markdown 파일에 동일한 편집 작업을 일괄 적용합니다.
  • 스크립트나 CI 작업에서 CSV 또는 다른 데이터 파일을 Markdown 표로 변환합니다.

빠른 시작

  1. 1

    Homebrew로 설치(macOS/Linux)

    brew install mq
  2. 2

    Markdown 파일에 쿼리를 실행해 코드 블록 추출

    mq '.code' README.md

사용 전 알아둘 점

  • 프로젝트가 활발히 개발 중이므로 변경될 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

mq은(는) 무엇인가요?
Markdown 파일을 선택·필터링·변환하는 jq 스타일 명령줄 도구이자 쿼리 언어입니다. mq를 사용하면 jq로 JSON을 다루듯 Markdown을 쿼리하고 변환할 수 있습니다. 짧은 표현식으로 제목, 코드 블록, 링크, 표, 섹션 같은 문서 일부를 선택한 뒤, 명령줄에서 필터링하거나 매핑하고 다시 작성할 수 있습니다. Rust로 작성되었으며 REPL, 에디터용 언어 서버, 디버거가 함께 제공됩니다.
mq은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mq은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mq은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mq의 마지막 커밋은 2026년 10월 22일입니다.
mq은(는) 어디에 사용할 수 있나요?
대규모 문서 모음에서 특정 섹션이나 코드 조각을 추출합니다. LLM 워크플로에 사용할 Markdown 프롬프트와 출력을 준비하거나 정리합니다. 저장소의 여러 Markdown 파일에 동일한 편집 작업을 일괄 적용합니다. 스크립트나 CI 작업에서 CSV 또는 다른 데이터 파일을 Markdown 표로 변환합니다.
mq는 어떻게 설치하나요?
Homebrew로 설치(macOS/Linux): brew install mq Markdown 파일에 쿼리를 실행해 코드 블록 추출: mq '.code' README.md
mq은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/harehare/mq

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트