Markdown ↔ HTML

존 그루버(John Gruber)가 창안한 마크다운(Markdown)은 태그의 복잡성을 걷어내고 텍스트 본연의 가독성과 구조에 집중할 수 있게 해주는 경량 마크업 언어입니다. 노션(Notion), 옵시디언(Obsidian), 깃허브(GitHub) 등 지식 관리 시스템(KMS)의 글로벌 표준 포맷으로 자리 잡았습니다.

하지만 마크다운 텍스트 자체로는 웹 브라우저에서 시각적으로 렌더링될 수 없습니다. 실제 웹페이지(티스토리, 워드프레스 등)에 문서를 배포하기 위해서는 브라우저가 이해할 수 있는 HTML 태그의 DOM 트리 구조로 반드시 컴파일되어야 합니다. 반대로, 과거 블로그에 작성해 둔 HTML 데이터를 최신 마크다운 플랫폼으로 이관(Migration)하려는 역변환 수요도 높습니다. 본 도구는 두 포맷 간의 구조를 오차 없이 상호 치환해 줍니다.

웹 환경에서 텍스트 구조를 변환하는 것은 단순한 문자열 찾기/바꾸기의 영역이 아닙니다. 중첩된 리스트, 인용구 블록, 테이블 등 복잡한 계층 구조를 보존하려면 고도화된 파싱(Parsing) 엔진이 필요합니다. 본 변환기는 추상 구문 트리(AST) 수준의 듀얼 코어 렌더링 메커니즘을 지원합니다.

※ 듀얼 코어 엔진 초기화 및 스펙 규격

// 1. Marked.js (MD -> HTML) : GFM(GitHub Flavored Markdown) 스펙 준수
marked.use({
  gfm: true,
  breaks: true, // 엔터를 
 태그로 정확히 변환
  headerIds: false // 불필요한 앵커 ID 생성 방지
});

// 2. Turndown.js (HTML -> MD) : 역변환 시 클린 마크다운 추출 옵션
const turndownService = new TurndownService({
  headingStyle: 'atx', // h1, h2 태그를 #, ## 기호로 통일
  codeBlockStyle: 'fenced', // 코드블록을 백틱 3개(```)로 통일
  emDelimiter: '*' // 기울임꼴(이탤릭)을 * 기호로 통일
});