MarkdownCo
Developer API

개발자를 위한 Markdown Converter API

단일 REST 엔드포인트로 Markdown, PDF, Word, HTML을 프로그래밍 방식으로 변환하세요. LaTeX 수식과 Mermaid 다이어그램 렌더링을 완벽하게 지원하며, 어떤 언어에서도 바로 호출할 수 있는 호스팅 서비스로 제공됩니다. RapidAPI에서 API 키를 발급받아 몇 분 안에 변환을 시작하세요.

RapidAPI에서 API 키 발급받기코드 예제 보기

Markdown 변환 API 퀵스타트

두 번의 호출로 완성됩니다: 파일을 제출해 task ID를 받고, 다운로드 URL이 준비될 때까지 폴링합니다. 모든 엔드포인트가 동일한 패턴을 따릅니다.

# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }

# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }

1. 변환 요청 제출

파일을 직접 업로드(source_file)하거나 공개 파일 URL(source_file_url)을 전송하면 task_id가 반환됩니다.

2. 결과 폴링

task_id를 사용해 query-task를 폴링하고, status가 completed가 되면 to_url에서 파일을 다운로드하세요.

YOUR_RAPIDAPI_KEY를 RapidAPI 대시보드의 키로 교체하세요. X-RapidAPI-Host 값도 대시보드에서 확인할 수 있습니다.

Markdown → PDF, Word, HTML API 엔드포인트

모든 엔드포인트는 multipart/form-data를 사용하는 POST 요청을 받으며, task_id를 반환합니다. 베이스 경로: /apix.

메서드엔드포인트설명온라인 도구
POST/apix/md-to-pdfLaTeX 수식과 Mermaid 다이어그램을 렌더링해 Markdown을 PDF로 변환합니다.온라인으로 사용
POST/apix/md-to-docxMarkdown을 편집 가능한 Word(.docx) 문서로 변환합니다.온라인으로 사용
POST/apix/md-to-htmlMarkdown을 시맨틱하고 깔끔한 HTML로 변환합니다.온라인으로 사용
POST/apix/pdf-to-mdPDF에서 텍스트, 표, 이미지를 포함한 Markdown을 추출합니다.온라인으로 사용
POST/apix/docx-to-mdWord(.docx) 문서를 Markdown으로 변환합니다.온라인으로 사용
POST/apix/html-to-mdHTML 페이지 또는 HTML 조각을 깔끔한 Markdown으로 변환합니다.온라인으로 사용
POST/apix/query-tasktask_id로 작업 상태를 폴링하고, 준비 완료 시 다운로드 URL을 가져옵니다.—

비동기 변환 API 동작 방식

변환은 비동기로 처리되므로 대용량 파일도 요청을 블로킹하지 않습니다.

요청 제출

Markdown, PDF, Word, HTML 파일을 업로드하거나 공개 URL로 지정해 해당 엔드포인트에 POST 요청을 보냅니다.

task ID 수신

API가 즉시 status processing 상태의 task_id를 반환합니다. 연결을 오래 유지할 필요가 없습니다.

폴링 및 다운로드

task_id를 사용해 query-task를 호출하세요. status가 completed가 되면 응답의 to_url에서 완성된 파일을 다운로드하세요.

Markdown Converter API가 렌더링하는 기능

LaTeX 수식부터 Mermaid 다이어그램까지, API는 복잡한 Markdown을 품질 손실 없이 깔끔한 PDF, Word, HTML로 변환합니다.

LaTeX 수식

인라인 및 블록 LaTeX 수식이 PDF와 Word 출력물에 정확하게 렌더링됩니다. 학술 문서 및 기술 문서 작성에 최적입니다.

Mermaid 다이어그램

Mermaid로 작성된 플로우차트, 시퀀스 다이어그램, Gantt 차트, 클래스 다이어그램이 실제 그래픽으로 렌더링됩니다.

GFM 완전 지원

파이프 테이블, 태스크 리스트, 구문 강조 코드 블록, 취소선, 자동 링크 등 GFM의 모든 요소가 완벽하게 보존됩니다.

양방향 변환

Markdown에서 PDF, Word, HTML로 변환하거나, 반대로 해당 포맷을 버전 관리에 적합한 깔끔한 Markdown으로 역변환할 수 있습니다.

Markdown 변환 API 활용 사례

개발자들은 이 API를 사용해 빌드 파이프라인, 제품 기능, 대량 작업에서 문서를 자동으로 생성합니다.

CI/CD 파이프라인

헤드리스 브라우저 없이, 모든 빌드 시 Markdown에서 릴리스 노트, 리포트, PDF 아티팩트를 자동 생성합니다.

문서화 도구

Markdown 문서를 사용자, 고객, 오프라인 열람을 위한 다운로드 가능한 PDF 또는 Word 파일로 자동 변환합니다.

대량 변환

공개 파일 URL을 전달해 서버 사이드에서 대량의 문서를 처리하고, task ID로 결과를 수집합니다.

Markdown Converter API 요금제

이 API는 RapidAPI를 통해 사용량 기반으로 과금되며, 시작을 위한 무료 티어와 사용량에 따라 확장할 수 있는 유료 플랜을 제공합니다. 결제, 키 관리, 요청 한도는 모두 RapidAPI 계정에서 관리됩니다.

Basic

$0 / 월

30

건 / 월

Pro

$7.90 / 월

800

건 / 월

+ $0.02 / request

추천

Ultra

$24.90 / 월

4,000

건 / 월

+ $0.012 / request

Mega

$49.90 / 월

12,000

건 / 월

+ $0.008 / request

요청 한도와 가격은 RapidAPI에서 설정되며 변경될 수 있습니다. 최신 정보는 현재 플랜 페이지에서 확인하세요.

RapidAPI에서 플랜 보기

Markdown API 연동 FAQ

Markdown 변환 API를 처음 사용하는 개발자가 구독, 인증, 요청 전송, 플랜 선택에 필요한 모든 정보를 담았습니다.

Markdown 변환 API는 어떻게 시작하나요?

RapidAPI 무료 계정을 생성하고, RapidAPI Hub에서 Markdown Converter Pro API를 열어 플랜을 구독하세요. Basic 플랜은 무료입니다. 구독 후에는 위의 코드 샘플을 사용해 모든 엔드포인트를 즉시 호출할 수 있습니다.

API 키는 어디서 확인하나요?

구독 후 RapidAPI가 계정에 개인 API 키를 발급합니다. RapidAPI 대시보드와 각 엔드포인트의 Code Snippets 탭에서 확인할 수 있습니다. 모든 요청에 X-RapidAPI-Key 헤더로 키를 전송하고, 함께 표시되는 X-RapidAPI-Host 헤더도 포함하세요.

API가 지원하는 변환 형식은 무엇인가요?

API는 Markdown → PDF, Word, HTML 변환과 그 역방향(PDF, Word, HTML → Markdown) 총 6개의 변환 엔드포인트와, 결과를 조회하는 query-task 엔드포인트를 제공합니다. 각 엔드포인트의 정확한 경로는 위의 엔드포인트 표에서 확인하세요.

변환 요청에 필요한 파라미터는 무엇인가요?

각 변환 엔드포인트는 multipart/form-data 요청을 받으며, source_file(파일 직접 업로드)과 source_file_url(공개 접근 가능한 파일 URL 지정) 중 하나를 사용합니다. 둘 다 전송할 경우 source_file이 우선합니다. 파일 크기는 최대 50 MB이며, 파일 형식이 엔드포인트와 일치해야 합니다. 예를 들어 md-to-pdf는 .md 파일을 필요로 합니다.

변환된 파일은 어떻게 받나요?

변환은 비동기로 처리되므로 성공한 요청은 파일 대신 task_id를 반환합니다. 해당 task_id를 query-task 엔드포인트에 전달해 status가 completed가 될 때까지 폴링하고, 응답의 to_url에서 완성된 파일을 다운로드하세요.

변환에 실패하면 어떻게 되나요?

변환을 완료할 수 없는 경우, query-task가 completed 대신 failed 상태를 반환합니다. 주요 원인은 엔드포인트와 일치하지 않는 파일 형식, 공개적으로 접근할 수 없는 source_file_url, 또는 50 MB를 초과하는 파일입니다. 입력값을 수정한 후 요청을 다시 제출하세요.

어떤 요금제를 선택해야 하나요?

무료 Basic 플랜으로 연동을 테스트한 후, 월별 요청 건수가 늘어남에 따라 유료 플랜으로 업그레이드하세요. 각 플랜에는 월별 요청 할당량이 포함되며, 초과 시 소정의 건당 요금이 부과됩니다. 현재 티어는 위의 요금 표에서 확인할 수 있습니다. 결제와 한도 관리는 RapidAPI 계정에서 이루어집니다.

변환 후 파일은 어떻게 처리되나요?

파일은 보관되지 않습니다. 업로드된 문서와 변환된 결과물은 처리 중에만 임시로 사용되고 이후 삭제됩니다. 완성된 파일은 장기 저장 없이 유효 기간이 짧은 다운로드 URL을 통해 제공됩니다.

지금 바로 몇 분 안에 변환을 시작하세요

RapidAPI에서 구독하고, 키를 발급받아, 오늘 첫 번째 변환 요청을 보내보세요.

RapidAPI에서 시작하기