liminfoHTML to Markdown
HTML을 마크다운으로 변환
HTML to Markdown 소개
HTML to Markdown 변환기는 HTML 마크업을 깔끔하고 읽기 쉬운 Markdown 구문으로 브라우저에서 변환합니다. 변환 엔진은 일련의 정규식 치환을 사용하여 모든 일반적인 HTML 요소를 처리합니다: h1~h6은 # 제목으로, strong/b는 **굵게**, em/i는 *기울임*, del/s는 ~~취소선~~, pre/code 블록은 삼중 백틱 코드 블록, 앵커 태그는 [텍스트](url) 링크, img 태그는  이미지 구문, ul/ol/li는 - 목록 항목, 인용문은 > 인용 줄로 변환됩니다.
개발자, 기술 작가, 블로거, 문서 작성자들이 HTML 기반 CMS(WordPress, Confluence 등)에서 Markdown 기반 플랫폼(GitHub, GitLab, Notion, Obsidian, 정적 사이트 생성기 등)으로 콘텐츠를 마이그레이션할 때 자주 사용합니다. 리치 텍스트 편집기 출력에서 HTML을 제거하거나, 이메일 템플릿을 문서 초안으로 변환하거나, Jekyll, Hugo, Next.js 같은 정적 사이트 생성기용 콘텐츠를 준비할 때도 유용합니다.
도구는 완전히 클라이언트 사이드에서 실행되며 HTML이 서버에 전송되지 않습니다. 변환 동작을 바로 확인할 수 있도록 샘플 HTML 문서가 입력 필드에 미리 로드되어 있습니다. 변환된 Markdown은 클릭 한 번으로 클립보드에 복사할 수 있습니다. &, <, >, ", ', 등의 HTML 엔티티 디코딩도 지원합니다.
주요 기능
- h1~h6 제목을 # ~ ###### Markdown 제목 구문으로 변환
- strong/b를 **굵게**, em/i를 *기울임* 인라인 서식으로 변환
- pre/code 블록을 엔티티 디코딩과 함께 ``` 펜스드 코드 블록으로 변환
- 앵커 태그를 [텍스트](url), img 태그를  Markdown 구문으로 변환
- ul/ol/li 목록을 - 글머리 기호로 목록 구조를 유지하며 변환
- blockquote 요소를 > 인용 줄로 변환, 여러 줄 인용문 지원
- HTML 엔티티 디코딩: &, <, >, ", ',
- 클릭 한 번으로 클립보드 복사, 샘플 HTML 사전 로드, 100% 클라이언트 사이드 처리
자주 묻는 질문
변환에서 지원하는 HTML 요소는 무엇인가요?
변환기는 다음을 처리합니다: 제목(h1-h6), 굵게(strong, b), 기울임(em, i), 취소선(del, s), 인라인 코드(code), 코드 블록(pre, pre/code), 링크(a href), 이미지(img src/alt), 순서 없는/있는 목록(ul, ol, li), 인용문(blockquote), 수평선(hr), 줄바꿈(br), 단락(p), div, span. href, src, alt 외의 HTML 속성은 제거됩니다.
중첩된 HTML 요소도 처리할 수 있나요?
변환기는 순차적인 정규식 치환을 사용하여 일반적인 HTML 패턴에 잘 작동합니다. 깊게 중첩되거나 복잡한 구조는 완벽하게 변환되지 않을 수 있습니다. 예를 들어, 중첩 목록은 들여쓰기 구조를 잃을 수 있습니다. 복잡한 문서의 경우 Turndown.js 같은 전용 라이브러리가 더 나은 결과를 제공할 수 있습니다.
코드 블록과 인라인 코드는 어떻게 다르게 처리되나요?
인라인 코드(pre 부모 없이 단독 code 태그)는 `백틱` 구문으로 변환됩니다. 코드 블록(pre 태그 또는 code를 포함한 pre 태그)은 삼중 백틱 펜스드 코드 블록으로 변환됩니다. 코드 블록 내의 HTML 엔티티는 펜스로 감싸기 전에 원래 문자(<, >, &)로 디코딩됩니다.
class, id, style 같은 HTML 속성은 어떻게 처리되나요?
변환기는 의미 있는 속성만 추출합니다: 앵커 태그의 href, 이미지 태그의 src와 alt. class, id, style, data-* 등 다른 모든 속성은 제거됩니다. 출력 Markdown에는 프레젠테이션 정보가 아닌 콘텐츠와 구조만 포함됩니다.
WordPress나 CMS 콘텐츠를 Markdown으로 변환하는 데 사용할 수 있나요?
네. 이 도구는 WordPress, Confluence, Notion 또는 HTML을 내보내는 모든 CMS의 콘텐츠를 변환하는 데 적합합니다. 페이지나 게시물의 HTML 소스를 입력 필드에 붙여넣으면 GitHub README 파일, 정적 사이트 생성기 또는 Markdown 기반 편집기에서 사용할 수 있는 Markdown이 생성됩니다.
단락 내의 줄바꿈이 보존되나요?
변환기는 br 태그를 줄바꿈으로, p 태그를 이중 줄바꿈(단락 구분)으로 변환합니다. 연속된 여러 줄바꿈은 최대 두 개로 압축됩니다. 텍스트 내의 인라인 공백은 그대로 보존됩니다. 출력은 두 개 이상의 연속된 빈 줄이 없도록 정리됩니다.
Markdown 출력이 예상보다 길게 나오는 이유는 무엇인가요?
Markdown은 다른 일부 마크업 언어와 달리 엄격한 줄 길이 요구 사항이 없습니다. 변환기는 원본 HTML의 자연스러운 텍스트 흐름을 보존합니다. 긴 줄을 줄바꿈해야 한다면 자동 줄바꿈을 지원하는 편집기에 Markdown 출력을 붙여넣거나 Markdown 포맷터를 사용하면 됩니다.
변환할 수 있는 HTML 크기에 제한이 있나요?
이 도구에는 명시적인 크기 제한이 없습니다. 변환이 JavaScript 정규식 연산을 사용하여 브라우저에서 이루어지므로, 매우 큰 HTML 문서는 처리에 시간이 걸릴 수 있습니다. 도구는 전체 웹사이트 내보내기보다는 일반적인 웹 페이지 콘텐츠, 블로그 게시물, 문서 페이지에 가장 잘 작동합니다.