PDF 를 다루는 도구는 대개 응용 프로그램이 되고 싶어 한다. MuPDF 의 자세는 엔진이다. C 라이브러리 하나, 명령 줄 프로그램 한 벌, 가벼운 보기 프로그램 하나. 이 선택이 무엇을 잘하는지와, 처음 한 시간이 상용 보기 프로그램을 여는 것과 왜 다르게 느껴지는지를 함께 설명한다.

응용이 아니라 엔진이라는 자리

공식 설명은 첫머리부터 정의다. MuPDF 는 PDF 와 XPS 와 전자책 문서를 보고 변환하고 조작하기 위한 오픈 소스 소프트웨어 틀이다. 그 둘레에 세 층이 있다. 각 플랫폼을 위한 보기 프로그램, 명령 줄 도구 한 벌, 그리고 다른 사람이 도구와 응용을 짓기 위한 라이브러리다.

이 모양이 쓰는 방식을 정한다. 설치해도 상용 보기 프로그램 같은 완성된 화면이 나오지 않고, 일상에서는 터미널에 명령을 치거나 자기 프로그램에서 불러 쓰는 쪽이 흔하다. 데스크톱 보기 프로그램 mupdf-gl 은 있지만 그 지향은 읽히는 것, 표시를 다는 것, 내용을 지우는 것이지 조판을 예쁘게 만드는 것이 아니다.

1.28.5 가 가져온 것

지금 판은 1.28.5 이고 해당 표시는 2026 년 9 월 25 일에 붙어 1.28 줄에 속한다.

문서 형식으로 Markdown 지원이 들어왔고 이것이 1.28 에서 가장 눈에 띄는 변화다. 명령 줄에는 mutool audit 이 늘어 PDF 의 구조를 분석해 보고를 만들며, 파일이 왜 열리지 않는지 쫓을 때 쓸 만하다. 글자 뽑기는 세부를 한꺼번에 고쳤다. 부드러운 붙임표와 단단한 붙임표의 구분, 합자의 분해, 문단 들여쓰기 인식, 가짜 굵은 글씨 판정이 포함된다. EPUB 와 HTML 그리기에는 vertical-align, 밑줄, 취소선, 강조 표시가 더해지고 :before 와 :after 라는 두 가짜 요소도 들어갔다. fz_check_document 도 늘었다. 문서를 먼저 훑어 생길 수 있는 구조 오류를 고쳐, 편집 도중에 파일이 조용히 고쳐지고 고친 내용까지 잃는 일을 피한다.

한 가지 더 살펴야 할 것은 선택 항목의 방식이 바뀐 점이다. PDF 쓰기 선택 항목의 decrypt 는 폐기 예정으로 표시되고 encrypt=none 으로 바뀌었다.

mutool, 열아홉 개의 하위 명령

명령 줄 도구는 하나의 입구에 모이고 공식은 그것을 맥가이버칼이라고 부른다. 하위 명령은 열아홉 개다. draw 는 문서를 그림으로 그리고, convert 는 형식을 바꾸고, clean 은 정리해 다시 쓰고, extract 는 그림과 글꼴을 뽑고, merge 는 합치고, pages 는 쪽을 늘리고 줄이고, poster 는 면을 잘라 늘어놓고, recolor 는 색을 바꾸고, sign 은 전자 서명을 넣고, barcode 는 줄무늬 부호를 만들고, trim 은 여백을 자르고, info 는 파일 정보를 알리고, show 는 아래층 대상을 찍고, run 은 JavaScript 를 돌리고, grep 은 정규 표현으로 글자를 찾고, trace 는 그리기 명령을 따라가고, create 는 새 PDF 를 만들고, bake 는 표시와 서식을 구워 넣고, audit 는 구조 분석을 맡는다.

일상에서 많이 쓰는 것은 draw 와 convert 둘이다. 앞의 것은 그리기를 맡아 점의 모음 그림을 내보내고, 뒤의 것은 형식 변환을 맡아 EPUB 을 PDF 로 만들거나 PDF 를 HTML 과 그림의 짝으로 나눈다.

보기 프로그램 mupdf-gl

데스크톱 쪽 주된 보기 프로그램은 mupdf-gl 이고 PDF, XPS, CBZ, EPUB, FB2 를 열며 흔한 점의 모음 그림과 SVG 도 본다. 기능이 빈약하지 않다. 옆 칸의 차례, Unicode 전체 검색, 표시 편집, 내용 지우기가 모두 들어 있다.

명령 줄 인자에는 쓸 만한 것이 몇 있다. 색을 뒤집는 방식, ICC 색 설정, 화면 확대 비율, EPUB 조판에 쓰는 면 너비와 높이와 글자 크기, 그리고 바깥 양식표를 출판사 양식 위에 덮는 스위치다. 오래 읽는 사람이라면 뒤집기 항목은 거의 반드시 켠다.

플랫폼 차이는 분명히 적어야 한다. Windows 에는 오래된 win32 보기 프로그램이 있고 X11 환경에는 mupdf-x11 이 있으며 둘 다 mupdf-gl 보다 기능이 한 단계 적다. macOS 는 Linux 와 같은 방식으로 빌드할 수 있다고 적혀 있지만 표준 보기 프로그램은 주지 않는다. 그래서 Mac 에서는 라이브러리와 명령 줄 도구로 쓰는 일이 많다.

읽는 형식

입력 쪽 공식 목록은 아홉 묶음을 든다. PDF, XPS 와 OpenXPS, EPUB(DRM 이 붙지 않은 2.0, 3.0 은 제한적 지원만), Mobipocket 의 MOBI, FictionBook 2 의 FB2, 만화 묶음인 CBZ 와 CBT, 흔한 점의 모음 그림(TIFF, JPEG, PNG 등), SVG 의 제한된 일부, 그리고 1.28 에서 늘어난 Markdown 이다.

출력 쪽에서 낼 수 있는 것은 PDF, 순수 글자, HTML, PostScript, PCL5 와 PCLM, PWG 와 CUPS, PNG 와 SVG 다. 들어오는 쪽과 나가는 쪽이 모두 갖춰져 있다.

내용 지우기와 서명

이 도구에서 내용 지우기는 검은 띠를 덮는 일이 아니다. 고른 범위의 내용을 파일에서 실제로 지우고 화소와 글자를 함께 다루므로, 지워진 글자는 나중에 다시 뽑을 수 없다. 바깥으로 보내거나 신원 정보를 뺀 채 보관하는 자리에서는 이 차이가 물러설 수 없는 조건이 된다.

전자 서명은 mutool sign 을 지난다. 넣을 수도 있고 확인할 수도 있다. 서명한 뒤에 문서가 손대어졌는지 보는 데 쓴다.

개발하는 쪽

핵심은 C 라이브러리이고 나머지 결합 층은 그 위에 자란다. Python 쪽은 PyMuPDF 로 데이터 뽑기와 분석이 중심이다. JavaScript 와 TypeScript 쪽은 MuPDF.js 로 Node 안에서 돈다. C# 쪽에도 대응하는 포장이 있다. 웹 페이지에 보기 프로그램을 넣으려면 상용 허락에 따른 별도 제품 줄이 있다.

2026 년 10 월 19 일 PyMuPDF 는 2.0 을 냈다. 내용은 주로 문제 수정으로, 뽑기에서의 붙임표 처리, 쪽을 돌린 뒤 머리말 표시의 위치, 기억 공간과 그리기에 관한 몇 가지 되돌림이 포함된다. 같은 날 각 플랫폼용 완전한 설치 꾸러미가 꾸러미 색인에서 조회되었다.

허락, 두 갈래

오픈 소스 쪽은 GNU AGPL 이다. 공식 설명은 그 점을 분명히 밝힌다. 이 허락은 프로젝트에 무료로 쓰는 것을 인정하지만 조건이 적지 않고, 그중 하나가 그것에 기대어 세운 체계의 완전한 소스를 공개하는 것이다. 닫힌 제품을 만들면서 소스를 보이고 싶지 않다면 다른 길로 가야 한다. 상용 허락이고, 사고 나면 AGPL 의 제약이 모두 풀린다.

한 문장 더 옮겨 둘 값이 있다. 소프트웨어는 있는 그대로 제공되며 어떤 보증도 따르지 않고 지원도 포함하지 않는다. 실제 운영에 넣으려면 이 점을 미리 비용에 넣어야 한다.

어디서 편하고 어디서 답답한가

PDF 를 한꺼번에 처리할 때, 글자를 뽑고 쪽을 나누고 합치고 그림으로 바꾸고 구조 검사를 돌리는 일은 명령 줄 한 벌이 화면 도구보다 훨씬 능률적이다. 명령 하나가 폴더 하나를 향한다. 자기 프로그램 안에서 그리기나 분석을 한다면 그대로 쓸 수 있는 아래층 엔진이고 결합 층도 넓다.

반대로 두 번 눌러 바로 열리고 보기 좋은 일상 보기 프로그램만 원한다면 이것은 맞지 않는다. 데스크톱 보기 프로그램은 기능의 충실함에 기울고 조작과 조판은 정교한 길을 가지 않으며, Mac 에서는 기본 보기 프로그램조차 주지 않는다.

MuPDF 의 값어치는 엔진 층에 있다. 아홉 가지 입력 형식, 열아홉 개의 하위 명령, 내용을 지우고 서명할 수 있는 보기 프로그램, 그리고 AGPL 과 상용의 이중 허락. 일반 사용자를 위한 읽기 소프트웨어가 아니라, 문서를 한꺼번에 처리해야 하는 사람이나 직접 도구를 지으려는 사람을 위한 아래층 부품 한 벌이다.