Jekyll을 사용하여 GitHub 페이지 사이트에 대한 Markdown 프로세서 설정

Markdown 프로세서를 선택하여 GitHub Pages 사이트에서 Markdown을 렌더링하는 방법을 결정할 수 있습니다.

누가 이 기능을 사용할 수 있는 있나요?

GitHub Pages은(는) 조직의 GitHub Free 및 GitHub Free이(가) 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud 및 GitHub Enterprise Server의 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다.

리포지토리에 대한 쓰기 권한이 있는 사용자는 GitHub Pages 사이트에 대한 Markdown 프로세서를 설정할 수 있습니다.

GitHub Pages는 kramdown 및 GitHub의 자체 Markdown 프로세서를 지원하며, 이는 GitHub Enterprise Server를 통해 GFM(GitHub Flavored Markdown) 을 렌더링하는 데 사용됩니다. 자세한 내용은 "GitHub에서의 쓰기 및 서식 지정 정보"을(를) 참조하세요.

GitHub Flavored Markdown을 두 프로세서에서 모두 사용할 수 있지만 GFM 프로세서만 GitHub Enterprise Server에 표시되는 결과와 항상 일치합니다.

  1. GitHub Enterprise Server에서 사이트의 리포지토리로 이동합니다.
  2. 리포지토리에서 _config.yml 파일을 검색합니다.
  3. 파일 보기의 오른쪽 위 모서리에서 을 클릭하여 파일 편집기를 엽니다.

파일의 스크린샷 머리글에서 연필 아이콘으로 레이블이 지정된 단추가 진한 주황색 윤곽선으로 표시되어 있습니다.

  1. markdown:로 시작하는 줄을 찾아 값을 kramdown 또는 GFM으로 변경합니다. 전체 줄은 markdown: kramdown 또는 markdown: GFM이어야 합니다.

  2. "커밋 메시지" 필드에, 파일의 변경 내용을 설명하는 커밋 메시지를 간결하고 명확하게 입력합니다. 커밋 메시지에서 둘 이상의 작성자가 커밋의 특성을 지정할 수 있습니다. 자세한 내용은 "여러 작성자와 커밋 만들기"을 참조하세요.

  3. 커밋 메시지 필드 아래에서 현재 분기 또는 새 분기에 커밋을 추가할지 여부를 결정합니다. 현재 분기가 기본 분기인 경우 커밋에 대한 새 분기를 만든 다음 끌어오기 요청을 만들도록 선택해야 합니다. 자세한 내용은 "끌어오기 요청 만들기"을 참조하세요.

    기본 분기에 직접 커밋하거나 새 분기를 만드는 라디오 단추를 보여 주는 GitHub 끌어오기 요청의 스크린샷. 새 분기를 선택했습니다.

  4. 변경 내용 커밋 또는 변경 내용 제안을 클릭합니다.

추가 참고 자료