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

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

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

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

All GitHub Pages builds will use GitHub Actions from June 30, 2024. No other changes are required but GitHub Actions must be enabled in your repository for builds to continue. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

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

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

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

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

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

참고: 원하는 경우 기본 파일 편집기를 사용하여 파일을 편집하고 커밋하는 대신, 드롭다운 메뉴를 선택하고 github.dev를 선택하여 github.dev 코드 편집기를 사용하도록 선택할 수 있습니다. GitHub Desktop 을(를) 클릭하여 GitHub Desktop을(를) 통해 리포지토리를 복제하고 로컬로 파일을 편집할 수도 있습니다.

파일의 스크린샷 머리글에서 아래쪽을 향한 삼각형 아이콘이 진한 주황색 윤곽선으로 표시되어 있습니다.

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

  1. 변경 내용 커밋... 을 클릭합니다.

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

  3. GitHub.com에서 계정과 연결된 이메일 주소가 두 개 이상 있는 경우 이메일 주소 드롭다운 메뉴를 클릭하고 Git 작성자 이메일 주소로 사용할 이메일 주소를 선택합니다. 이 드롭다운 메뉴에는 확인된 이메일 주소만 표시됩니다. 이메일 주소 개인정보 보호를 사용하도록 설정한 경우 <username>@users.noreply.github.com이 기본 커밋 작성자 이메일 주소입니다. 자세한 내용은 "커밋 메일 주소 설정"을 참조하세요.

    커밋 작성자 이메일 주소를 선택할 수 있는 옵션이 있는 드롭다운 메뉴를 보여 주는 GitHub 끌어오기 요청의

    스크린샷. octocat@github.com을 선택했습니다.

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

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

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

추가 참고 자료