Markdown to HTML 게시: GFM 구문 지원 범위 및 인라인 스타일 가이드

GFM은 GitHub에서 정의한 Markdown 확장 사양으로, 기본 구문 외에 4가지 일반적인 유형의 확장을 포함합니다. OKfmt의 Markdown to HTML 변환기는 4가지 모든 유형의 확장에 대한 완전한 형식 변환을 지원하며, 표준 의미에 맞는 HTML 태그를 출력합니다.

4가지 유형의 확장은 정렬 속성이 적용된 표, 취소선 텍스트, 작업 목록 및 감싼 코드 블록입니다. 변환 후 원본 구문의 구조와 스타일 정보가 유지되므로 대부분의 공개 콘텐츠 게시 플랫폼의 표시 요구 사항을 충족합니다.

OKfmt의 Markdown to HTML 변환기는 기본적으로 DOCTYPE 선언이 포함된 완전한 HTML5 문서를 출력하며, 모든 타이포그래피 스타일은 인라인 CSS로 해당 태그에 작성됩니다. 변환 결과는 외부 스타일 시트에 의존하지 않아도 정상적으로 표시됩니다.

이 출력 방식은 외부 스타일을 지원하지 않는 게시 시나리오, 예를 들어 기업 내부 이메일 본문, 사용자 정의 CSS를 허용하지 않는 콘텐츠 관리 시스템, 제3자 블로그 플랫폼의 리치 텍스트 편집 영역에 적합합니다. 사용자는 변환된 HTML 코드를 복사하여 직접 붙여넣고 게시할 수 있습니다.

일부 Markdown 편집기는 사용자가 콘텐츠에 원시 HTML 태그를 임베드하는 것을 허용합니다. 이러한 태그에는 악성 스크립트 코드가 포함될 수 있어 게시된 페이지에 보안 위험을 유발합니다. OKfmt는 원시 입력 HTML 태그를 렌더링하지 않는 보호 메커니즘을 채택합니다.

도구는 입력 콘텐츠의 원시 HTML 태그를 이스케이프 처리하여 일반 텍스트로 출력하므로 변환된 HTML 문서에서 태그가 실행되는 것을 방지하고 XSS 크로스 사이트 스크립팅 주입 공격을 막아 게시된 페이지의 접근 보안을 보장합니다.

OKfmt의 Markdown to HTML 변환기는 형식 변환만 수행하며 이미지 리소스의 전송이나 저장은 처리하지 않습니다. 변환 중 원본 Markdown 콘텐츠의 이미지 링크 주소는 그대로 유지되어 생성된 HTML의 img 태그의 src 속성에 직접 작성됩니다.

사용자는 원본 이미를 대상 플랫폼의 이미지 호스팅 또는 저장 서버에 직접 업로드한 후 해당 링크 주소를 교체해야 합니다. 도구 자체는 사용자가 업로드한 어떤 콘텐츠도 저장하지 않으며 모든 변환 작업은 사용자의 로컬 브라우저에서 완료됩니다.

OKfmt는 역방향 HTML to Markdown 형식 변환 서비스도 제공합니다. 이 서비스의 핵심 적용 시나리오는 공개 웹 콘텐츠의 Markdown 아카이빙입니다. 사용자는 웹 페이지 텍스트의 HTML 콘텐츠를 복사하여 구조화된 Markdown 텍스트로 변환한 뒤 저장할 수 있습니다.

변환 과정에서는 제목 수준, 목록, 링크, 이미지를 포함한 원본 콘텐츠의 구조를 유지하고 웹 페이지에 포함된 내비게이션, 광고 등의 중복 코드를 제거합니다. 변환된 Markdown은 개인 지식 노트 아카이빙에 사용하거나 2차 편집 후 재게시할 수 있습니다.