---
title: "Typst와 AsciiDoc을 스캔된 PDF로: CLI도 Ruby도 업로드도 필요 없습니다"
description: "이제 Look Scanned에서 Typst와 AsciiDoc 소스 파일을 열 수 있습니다. .typ 또는 .adoc 파일을 넣고 미리보기에서 페이지를 확인한 뒤, 실제 스캐너에서 나온 것 같은 PDF로 저장하세요."
date: 2026-10-08T05:00:00.000Z
lang: ko
source: https://lookscanned.io/ko/blog/typst-asciidoc-to-scanned-pdf
tags: ["Typst", "AsciiDoc", "PDF", "업데이트"]
---

# Typst와 AsciiDoc을 스캔된 PDF로: CLI도 Ruby도 업로드도 필요 없습니다

모든 문서가 Word에서 시작되지는 않습니다. LaTeX와 씨름하지 않고 논문, 편지, 이력서, 강의 노트를 쓰려고 Typst를 고르는 사람이 늘었고, 매뉴얼과 사양서, 운영 문서를 AsciiDoc으로 관리하는 팀도 많습니다. 그런데 누군가 서명한 스캔본을 달라고 하면, 지금 쓰는 컴퓨터에는 소스 파일밖에 없을 때가 있습니다.

이제 Look Scanned에서 두 형식을 모두 열 수 있습니다. `.typ` 파일은 [Typst(.typ)를 스캔된 PDF로 변환](https://lookscanned.io/ko/scan/typst)에서, `.adoc`과 `.asciidoc` 파일은 [AsciiDoc(.adoc)을 스캔된 PDF로 변환](https://lookscanned.io/ko/scan/asciidoc)에서 엽니다. 문서는 브라우저 안에서 페이지로 만들어집니다. 미리보기에서 확인하고 스캔 효과를 더하면, 실제 스캐너를 거친 것 같은 PDF를 내려받을 수 있습니다. Typst CLI를 설치할 필요도, Ruby나 Asciidoctor PDF를 설치할 필요도, 계정에 로그인할 필요도 없습니다.

## Typst: 브라우저에서 돌아가는 진짜 컴파일러

Look Scanned는 브라우저용으로 빌드한 공식 Typst 컴파일러(Typst 0.14)를 실행합니다. `typst compile`과 같은 컴파일러이므로 페이지, 줄바꿈, 수식, 표가 내 컴퓨터에서 컴파일한 것과 똑같이 나오고, 문서에서 지정한 용지 크기와 여백도 그대로 적용됩니다.

- **처음 한 번은 조금 기다려야 합니다.** 컴파일러와 Typst 글꼴(합쳐서 약 20 MB)을 처음에만 Look Scanned에서 내려받습니다. 그다음부터는 브라우저 캐시에서 불러오므로 오프라인에서도 Typst 파일을 열 수 있습니다.
- **파일 하나만, 패키지는 안 됩니다.** 파일 하나로 완결된 문서만 컴파일됩니다. 패키지를 내려받을 저장소가 없어서 `#import "@preview/…"` 줄은 오류가 납니다. 다른 파일을 읽는 것도 마찬가지입니다. `#image`로 넣는 그림, `#include`로 불러오는 장, CSV나 JSON 파일에서 읽어 오는 데이터는 쓸 수 없습니다.
- **Typst 기본 글꼴만 씁니다.** 본문은 Typst에 포함된 글꼴로 조판됩니다. Libertinus Serif, New Computer Modern과 그 수식 글꼴, 코드용 DejaVu Sans Mono입니다. 컴퓨터에 설치된 글꼴은 쓸 수 없으므로 문서에서 지정한 다른 글꼴은 이 글꼴들로 대체됩니다. 라틴 문자(베트남어 포함), 그리스 문자, 키릴 문자, 히브리 문자는 지원합니다. 한국어, 중국어, 일본어 텍스트는 대신 쓸 글꼴이 아예 없고, 아랍 문자, 태국 문자, 데바나가리 같은 문자도 제대로 지원되지 않으므로 문서에 이런 문자가 있다면 미리보기에서 확인하세요.
- **소스가 컴파일되어야 합니다.** Typst가 오류를 보고하면 페이지 대신 오류 메시지가 표시됩니다.

Typst는 스캔 효과를 입히기 전에 진짜 PDF를 먼저 만들기 때문에, 그 텍스트를 함께 남길 수 있습니다. PDF로 저장할 때 '출력 설정'에서 '원본 텍스트 유지 (OCR과 유사)'를 켜면 스캔된 PDF에서도 텍스트를 검색하고 복사할 수 있습니다.

## AsciiDoc: Ruby 없이 쓰는 Asciidoctor

AsciiDoc 파일은 AsciiDoc의 표준 처리기인 Asciidoctor가 변환합니다. 여기서는 브라우저에서 돌아가는 JavaScript 버전을 씁니다. 결과는 여백 1인치의 A4 페이지에 배치되며, 다음 요소가 반영됩니다.

- 문서 헤더: 제목, 저자, 개정 정보 줄. 문서에 `:toc:`가 설정되어 있으면 목차도 들어갑니다.
- 섹션, 목록, 표, 각주, 인용문, 코드 콜아웃. 안내 블록(admonition)은 아이콘 대신 Note나 Warning 같은 레이블을 글자로 표시합니다.
- 문서에 `:stem:`이 설정되어 있으면 STEM 수식이 제대로 된 수식 글꼴로 조판됩니다. AsciiMath와 LaTeX 표기를 모두 쓸 수 있고, 인라인과 블록 모두 지원합니다.
- 문서에 `:source-highlighter:`가 설정되어 있으면 어떤 하이라이터를 지정했든 코드 목록에 구문 색상이 입혀집니다. 이 속성이 없으면 다른 곳에서와 마찬가지로 색 없이 표시됩니다.
- 긴 표와 코드 목록은 다음 페이지로 이어지고, 표의 행이 중간에서 잘리지 않습니다.

반영되지 않는 것도 있습니다.

- **`include::`는 따라가지 않습니다.** include 지시문은 포함될 내용 대신 해당 경로를 가리키는 링크로 표시됩니다. 먼저 여러 부분을 파일 하나로 합치세요.
- **이미지는 전체 웹 주소가 필요합니다.** `images/diagram.png`처럼 상대 경로로 참조한 이미지는 찾을 수 없습니다. 파일이 폴더 없이 단독으로 열리기 때문입니다. 전체 `https://` 주소가 있는 이미지는 해당 사이트에서 불러오므로 인터넷 연결이 필요합니다.
- **다이어그램은 소스 그대로입니다.** Asciidoctor Diagram을 쓸 수 없어서 PlantUML이나 Mermaid 블록은 입력한 텍스트 그대로 나옵니다.
- **글꼴은 사용 중인 기기의 것입니다.** 본문은 컴퓨터나 휴대폰에 설치된 글꼴로 조판되므로, 같은 파일이라도 기기에 따라 페이지가 나뉘는 위치가 달라질 수 있습니다.
- **아주 긴 파일은 시간이 초과될 수 있습니다.** 레이아웃은 약 30초 안에 끝나야 하므로 책 한 권 분량의 문서는 작은 파일로 나누세요.
- **`.asc` 파일은 받지 않습니다.** 이 확장자는 보통 PGP 키와 서명에 쓰입니다. AsciiDoc 파일이라면 열기 전에 이름을 `.adoc`으로 바꾸세요.

## .typ 또는 .adoc 파일을 스캔된 PDF로 바꾸는 방법

1. [Typst(.typ)를 스캔된 PDF로 변환](https://lookscanned.io/ko/scan/typst) 또는 [AsciiDoc(.adoc)을 스캔된 PDF로 변환](https://lookscanned.io/ko/scan/asciidoc)을 열고 파일을 선택합니다.
2. 페이지가 준비될 때까지 잠시 기다린 다음 미리보기를 한 페이지씩 넘겨 봅니다. 제목, 수식, 표, 코드를 확인하세요.
3. 스캔 효과를 조정합니다. 작은 글씨나 빽빽한 수식이 있다면 흐림과 노이즈를 낮게 유지하세요.
4. “스캔된 PDF 생성”을 클릭한 다음 “스캔된 PDF 다운로드”를 클릭합니다.

이미지가 더 편하다면 각 페이지를 JPG나 PNG로 내보낼 수도 있습니다. 어떤 형식이 언제 좋은지는 [PDF, JPG, PNG 안내](https://lookscanned.io/ko/blog/scanned-document-pdf-jpg-png)에서 확인하세요. Pro를 사용하면 [일괄 스캔](https://lookscanned.io/ko/scan/bulk)으로 여러 `.typ` 또는 `.adoc` 파일을 한 번에 처리할 수 있습니다.

## 파일은 내 기기 밖으로 나가지 않습니다

두 형식 모두 변환과 스캔이 브라우저 안에서 이루어지며, 소스 파일은 서버로 업로드되지 않습니다. Typst는 Look Scanned 자체 사이트에서 컴파일러와 글꼴만 내려받고, 패키지나 다른 파일은 가져오지 않습니다. AsciiDoc의 유일한 예외는 전체 `https://` 주소가 있는 이미지로, 브라우저에서 그 페이지를 열 때와 마찬가지로 이미지를 호스팅하는 사이트에서 가져옵니다.

## 알아 두면 좋은 점

- **결과물은 이미지로 이루어져 있습니다.** 실제 스캔본처럼 PDF의 텍스트를 선택하거나 검색할 수 없습니다. 단, Typst 파일에서 위의 텍스트 옵션을 켰다면 예외입니다. 편집용으로 `.typ` 또는 `.adoc` 소스는 보관해 두세요.
- **스캔 효과는 항상 적용됩니다.** Look Scanned는 문서를 스캔한 것처럼 보이게 하는 도구입니다. 깔끔한 PDF만 필요하다면 Typst나 Asciidoctor PDF로 내보내세요.
- **패키지, include, 다이어그램이 필요하다면?** Typst나 Asciidoctor PDF가 설치된 컴퓨터에서 PDF를 만든 다음, 그 PDF에 Look Scanned로 스캔 효과를 더하세요. 어려운 부분은 원래 도구가 이미 처리했으므로 어떤 문서든 이 방법이면 됩니다.

다른 형식으로 쓰고 있나요? Look Scanned가 [LaTeX 파일](https://lookscanned.io/ko/blog/latex-to-scanned-pdf)과 [Markdown, HTML, TXT 파일](https://lookscanned.io/ko/blog/html-markdown-to-scanned-pdf)을 어떻게 처리하는지도 확인해 보세요.

스캔한 것처럼 보여야 하는 `.typ`나 `.adoc` 파일이 있나요? [Typst](https://lookscanned.io/ko/scan/typst)와 [AsciiDoc](https://lookscanned.io/ko/scan/asciidoc), 지금 바로 해 보세요.