마크다운을 HTML로 바꾸면 좋은 경우
- 누구에게나 공유 — 마크다운 뷰어는 없어도 브라우저는 누구나 있습니다.
- 게시 — HTML을 게시판, 뉴스레터 도구, 정적 페이지에 붙여 넣을 수 있습니다.
- 미리보기 — 제목, 표, 목록이 어떻게 보이는지 정확히 확인할 수 있습니다.
변환 방식
marked 라이브러리로 GitHub 방식 규칙에 따라 마크다운을 해석하고, 결과 HTML에서 안전하지 않은 요소를 걷어낸 뒤, 문서의 첫 제목을 페이지 제목으로 하는 독립 페이지로 만듭니다.
마크다운(Markdown) 파일이란?
마크다운(.md)은 # 제목, **굵게**, *기울임*, - 목록처럼 일반 문자만으로 서식을 표현하는 가벼운 문서 작성 방식입니다. 원본 그대로 읽어도 자연스럽고, HTML로 깔끔하게 변환됩니다.
GitHub의 README 파일과 각종 기술 문서, 옵시디언(Obsidian) 같은 메모 앱, 노션(Notion) 내보내기, 정적 사이트 생성기 등 다양한 곳에서 쓰입니다.
HTML 파일이란?
HTML(HyperText Markup Language)은 웹 페이지를 만드는 언어입니다. HTML 파일은 제목을 뜻하는 <h1>, 문단을 뜻하는 <p>, 그림을 넣는 <img> 같은 태그가 들어 있는 텍스트 파일이며, 운영체제와 상관없이 모든 웹 브라우저에서 별도 프로그램 없이 열립니다.
제목, 목록, 표, 링크, 강조 같은 구조를 유지하면서도 어디서나 열 수 있어 문서를 읽거나 공유하기 좋은 형식입니다. 이미지를 파일 안에 포함해 HTML 파일 하나로 완결시킬 수도 있습니다.