#Markdown 처리

Markdown 문서를 변환하려면 -f text/markdown을 넘기거나 .md/.markdown 확장자를 사용합니다. Gukhanmun은 Markdown 본문 속의 한자를 변환하고, 자신이 간섭하지 않는 구문은 그대로 둡니다. GitHub Flavored Markdown(표, 각주, 취소선, 할 일 목록)을 켜려면 variant 매개변수를 더합니다:

gukhanmun -f "text/markdown; variant=GFM" input.md

#YAML 프런트 매터

파일 맨 위의 YAML 프런트 매터(---로 구분된 블록)는 변환 전에 항상 인식되어 분리되므로, Markdown 변환기에 의해 망가지지 않습니다. 기본적으로는 그대로 통과되고 Markdown 본문만 변환됩니다.

선택된 프런트 매터 값까지 함께 변환하려면 --markdown-frontmatter-convert를 사용하여 JSONPath 식으로 그 값을 가리킵니다. 이 플래그는 반복할 수 있습니다:

gukhanmun -f text/markdown \
  --markdown-frontmatter-convert '$.hero.tagline' \
  --markdown-frontmatter-convert '$.hero.actions[*].text' \
  page.md

선택자에 일치하는 각 값은 국한문 혼용체에서 한글로 변환됩니다. 문자열 스칼라만 변환되며, 수치나 진위值 등 문자열이 아닌 일치 대상과 어떤 선택자도 가리키지 않는 필드는 그대로 둡니다.