HTML을 마크다운으로 변환

HTML 파일을 올리거나 페이지 URL을 붙여넣으면 읽기 좋은 마크다운이 나옵니다. ParseJet은 중첩된 div, 인라인 스타일, 옛날식 마크업 같은 실제 웹의 지저분한 HTML도 처리해 각 요소를 정확한 마크다운 문법으로 옮깁니다. 콘텐츠 이전, 기술 문서, LLM 파이프라인을 위해 만들어졌습니다.

여기에 파일을 끌어다 놓거나 찾아보기

HTML,HTM 파일 지원

무료 — 하루 3회 요청, 가입 불필요. 하면 월 300 크레딧 무료.

작동 방식

HTML 업로드 또는 URL 입력

.html 파일을 위에 끌어다 놓거나, 실제 페이지 URL을 붙여넣으세요. 두 방식 모두 같은 품질의 마크다운을 만듭니다.

마크다운으로 변환

ParseJet이 HTML을 파싱해 스크립트, 스타일, 추적 코드를 버리고 제목, 목록, 표, 링크, 코드 블록을 마크다운으로 매핑합니다.

복사 또는 API 사용

결과를 복사하거나, API를 연동해 애플리케이션이나 마이그레이션 스크립트 안에서 HTML을 마크다운으로 변환하세요.

주요 기능

이 html to markdown가 돋보이는 이유.

모든 요소 매핑

h1–h6, 번호·글머리 기호 목록, 표, 인용문, 코드 블록, 굵게·기울임, 링크가 모두 정확히 대응하는 마크다운으로 변환됩니다.

지저분한 HTML도 처리

실제 HTML은 깔끔한 경우가 드뭅니다. 닫히지 않은 태그, 깊게 중첩된 div, 인라인 스타일, 레거시 마크업이 있어도 결과가 무너지지 않습니다.

스크립트·스타일 제거

JavaScript, CSS, 추적 픽셀, HTML 주석은 완전히 제거됩니다. 마크다운 결과물에 한 줄도 새어 들어가지 않습니다.

파일과 URL 모두 지원

WordPress 내보내기 같은 저장된 .html 파일을 변환하거나 URL로 실제 페이지를 가져올 수 있습니다. 같은 엔드포인트가 둘 다 처리합니다.

엔티티·인코딩 안전

HTML 엔티티(&,  , —)는 실제 문자로 디코딩되고 출력은 항상 UTF-8입니다. 한글이 깨질 일이 없습니다.

API 일괄 변환

짧은 스크립트 하나로 내보내기 폴더의 HTML 파일 전체를 마크다운으로 바꿀 수 있습니다. 아래 Python 예제를 참고하세요.

사용 사례

이 도구가 시간을 절약해주는 일반적인 시나리오.

CMS·블로그 이전

WordPress, Ghost, 레거시 CMS의 콘텐츠를 Hugo, Astro, Jekyll 같은 마크다운 기반 스택으로 옮기세요. HTML을 손으로 정리할 필요가 없습니다.

기술 문서 변환

Confluence나 MediaWiki에서 내보낸 HTML 문서를 마크다운으로 바꿔 Git 기반 docs-as-code 워크플로우에 넣으세요.

LLM 입력 전처리

원시 HTML은 마크업 잡음에 토큰을 낭비합니다. 먼저 마크다운으로 변환해 문서 구조는 유지하면서 압축된 텍스트를 모델에 넣으세요.

크롤링 결과 정제

크롤러가 수집한 HTML을 문서당 API 한 번으로 깔끔한 마크다운으로 바꿔 저장, 색인, NLP 처리에 사용하세요.

API로 자동화

동일한 도구를 프로그래밍 방식으로 사용하세요. 모든 언어와 호환 — 단순히 HTTP입니다.

cURL

# Convert a local HTML file to Markdown
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

# Convert a live page by URL
curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/page"}'

Python

import httpx
from pathlib import Path

# Batch-convert an HTML export folder to Markdown files
html_dir = Path("export/")
md_dir = Path("markdown/")
md_dir.mkdir(exist_ok=True)

for html_file in html_dir.glob("*.html"):
    resp = httpx.post(
        "https://api.parsejet.com/v1/parse/auto/file",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"file": (html_file.name, html_file.read_bytes(), "text/html")},
    )
    md_path = md_dir / html_file.with_suffix(".md").name
    md_path.write_text(resp.json()["text"], encoding="utf-8")
    print(f"Converted {html_file.name} -> {md_path.name}")

JavaScript

// Convert an HTML file (e.g. from a file input) to Markdown
const formData = new FormData();
formData.append("file", htmlFile); // File or Blob with .html content

const res = await fetch("https://api.parsejet.com/v1/parse/auto/file", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: formData,
});
const { text } = await res.json();
console.log(text); // Markdown string

자동화하고 싶으신가요?

ParseJet API는 단일 HTTP 엔드포인트를 통해 동일한 파싱 기능을 제공합니다. ffmpeg, poppler, tesseract 없이 — 단 한 번의 API 호출만으로 가능합니다.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

API 문서 읽기

자주 묻는 질문

HTML을 마크다운으로 어떻게 변환하나요?

.html 파일을 위에 업로드하거나 페이지 URL을 붙여넣으세요. ParseJet이 마크업을 파싱해 제목, 목록, 표, 링크가 살아 있는 마크다운을 돌려줍니다. 자동화하려면 /v1/parse/auto/file 또는 /v1/parse/webpage로 POST하세요.

표도 제대로 변환되나요?

네. HTML 표는 헤더 행과 정렬된 열을 갖춘 마크다운 표가 됩니다. 중첩 목록, 인용문, 코드 블록도 각각 대응하는 마크다운 문법으로 변환됩니다.

스크립트, 스타일, 주석은 어떻게 처리되나요?

전부 제거됩니다. 결과물에는 문서에서 읽을 수 있는 내용만 남고 JavaScript, CSS, 추적 코드는 포함되지 않습니다.

파일 대신 실제 웹페이지를 변환할 수 있나요?

네. 위 도구에 URL을 붙여넣거나, 실제 페이지의 본문 추출과 광고·메뉴 제거에 최적화된 URL 마크다운 변환 도구를 사용하세요.

Python에서 HTML을 마크다운으로 변환하려면?

httpx나 requests로 파일을 /v1/parse/auto/file에 POST하면 응답의 "text" 필드가 곧 마크다운입니다. html2text, BeautifulSoup, markdownify를 설치할 필요가 없습니다. 위 Python 예제를 참고하세요.

무료인가요?

네. 가입 없이 하루 3회 무료로 변환할 수 있고, 무료 계정을 만들면 월 300 크레딧을 받습니다. 대량 마이그레이션은 월 $19부터의 유료 플랜을 이용하세요.

무료로 텍스트 추출 시작하기

가입 불필요. 몇 초 만에 첫 파일을 파싱하세요.

가격 보기