HTML을 Markdown으로 변환하는 방법
- HTML 일부를 붙여넣거나 지원되는
.html파일을 업로드합니다. - 소스를 변환하고 Markdown에서 어떤 의미 체계(세맨틱) 요소가 여전히 유의미한지 검토합니다.
- 링크, 이미지, 중첩 목록, 표 및 코드 펜스를 변환하고 확인합니다.
- Markdown을 복사하거나
.md파일을 다운로드합니다.
변환기는 무엇을 보존하나요?
| 소스 콘텐츠 | 권장되는 출력 동작 | 변환 메모 |
|---|---|---|
| 제목 | <h1>~<h6>을 Markdown 제목으로 매핑 | |
| 단락 및 강조 | 단락, 굵게 및 기울임꼴 변환 | |
| 목록 | 순서 있는 목록, 순서 없는 목록 및 중첩 목록 변환 | |
| 링크 | 텍스트 및 확인된 URL 보존 | |
| 이미지 | 소스 및 대체 텍스트(alt) 보존 | |
| 코드 | 인라인 코드 및 펜스 블록 사용 | |
| 표 | 호환되는 표를 GFM으로 변환 | |
| 인용구 | 의미 체계적 인용구 변환 |
변환 과정에서 무엇이 변경될 수 있나요?
스크립트, 스타일 및 양식
실행 가능하고 대화형 요소는 일반적인 Markdown에 상응하는 것이 없으므로 생략되거나 텍스트로 단순화될 수 있습니다.
복잡한 표
행 병합(rowspan), 열 병합(colspan), 중첩된 표 및 서식이 있는 셀 콘텐츠는 원시 HTML을 사용하거나 평탄화(flattening)해야 할 수 있습니다.
상대 URL
붙여넣은 일부 코드에는 페이지의 기본 URL이 포함되어 있지 않을 수 있으므로 상대 링크 및 이미지 경로가 항상 확인될 수는 없습니다.
레이아웃 컨테이너
div, 그리드 및 플렉스박스 레이아웃은 의미 체계적인 읽기 순서를 정의하지 않습니다.
숨겨진 콘텐츠 및 표준 문구(Boilerplate)
변환기에는 숨겨진 요소, 탐색 및 시각적으로 축소된 콘텐츠에 대한 명확한 정책이 필요합니다.
HTML to Markdown의 일반적인 용도
웹 문서 마이그레이션
의미 체계적인 HTML을 Markdown 기반 문서 시스템으로 이동합니다.
복사된 서식 있는 텍스트 정리
버전 관리 또는 게시 전에 에디터에서 생성된 HTML을 더 간단한 형식으로 변환합니다.
코드 예제 준비
전체 페이지 스타일시트를 가져오지 않고 코드 블록과 제목만 보존합니다.
텍스트 위주의 AI 컨텍스트 생성
검토해야 하는 정보 구조를 유지하면서 스크립트와 스타일을 제거합니다.
HTML to Markdown 변환 예시
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- Test더 깔끔한 Markdown 출력을 위한 팁
- 의미 체계적인 HTML 사용 제목, 목록, 표는 일반 레이아웃 컨테이너보다 더 안정적으로 변환됩니다.
- 필요한 경우 기본 URL 제공 상대 링크가 원래 페이지 외부에서 작동하려면 컨텍스트가 필요합니다.
- 출력 방언(Dialect) 선택 GFM은 기본 CommonMark가 정의하지 않은 표와 작업 목록을 지원합니다.
- 코드 펜스 검토 감지된 프로그래밍 언어와 포함된 백틱을 확인합니다.
- 원시 HTML 대체(Fallback) 결정 지원되지 않는 HTML을 유지하면 정보를 보존할 수 있지만 이식성이 떨어질 수 있습니다.
자주 묻는 질문
<script> 및 <style> 요소는 제거되나요?
스크립트와 스타일은 유용한 Markdown 콘텐츠가 아니므로 결과물에서 이에 의존해서는 안 됩니다. 출력을 재사용하기 전에 붙여넣은 HTML을 검토하세요.
HTML 표는 Markdown 표로 변환되나요?
호환되는 직사각형 표는 GFM 표가 될 수 있습니다. rowspan, colspan, 중첩된 블록 또는 여러 헤더 행이 있는 표는 문서화된 대체(fallback)가 필요합니다.
코드 블록과 인라인 코드는 보존되나요?
<pre> 및 <code>에서 매핑될 수 있습니다.
링크와 이미지는 어떻게 되나요?
유효한 링크 텍스트와 대상은 유지될 수 있습니다. 업로드된 소스 조각에 보장된 기본 URL이 없으므로 상대 링크와 이미지 경로는 컨텍스트에 따라 다릅니다.
지원되지 않는 HTML 태그는 제거되나요, 아니면 보존되나요?
표시 전용 래퍼는 단순화되고 읽을 수 있는 텍스트는 보존될 수 있습니다. 사용자 정의 요소가 의미를 가질 때 출력과 소스를 비교해 보세요.
변환기는 CommonMark 또는 GFM을 출력하나요?
의도된 출력은 GitHub-Flavored Markdown입니다. 표, 취소선 및 작업 목록은 GFM 확장 기능에 의존합니다.
HTML 문서 전체를 붙여넣을 수 있나요?
네. 일부 조각을 붙여넣거나 .html 또는 .htm 파일을 업로드한 다음 생성된 Markdown을 검토할 수 있습니다.
이 페이지에서 실제 웹사이트 URL을 변환할 수 있나요?
아니요. 이 페이지는 붙여넣은 HTML 또는 업로드된 HTML 파일만 허용하며, 실제 웹사이트 URL을 가져오지는 않습니다.
Markdown을 다시 PDF로 변환
이미 Markdown 파일이 있으신가요? 공유 가능한 PDF를 만들려면Markdown to PDF 변환기를 사용하세요.