Настройка процессора Markdown для вашего сайта GitHub Pages с помощью Jekyll

Вы можете выбрать обработчик Markdown, чтобы определить способ отрисовки Markdown на сайте GitHub Pages.

Кто может использовать эту функцию?

GitHub Pages доступен в общедоступных репозиториях с GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях с GitHub Pro, GitHub Team, GitHub Enterprise Cloudи GitHub Enterprise Server.

Примечание.

Хотя драгоценный github-pages камень остается поддерживаемым для некоторых рабочих процессов, GitHub Actions теперь является рекомендуемым подходом для развертывания и автоматизации сайтов GitHub Pages.

Пользователи с разрешениями на запись для репозитория могут задать обработчик Markdown для сайта GitHub Pages.

GitHub Pages поддерживает два процессора Markdown: [kramdown и GitHubсобственного процессора Markdown, который используется для отрисовки GitHub В формате Markdown (GFM)](https://github.github.com/gfm/) на GitHub. Дополнительные сведения см. в разделе О написании и форматировании на GitHub.

Вы можете использовать GitHub С помощью с помощью любого процессора.

  1. На сайте GitHubперейдите в репозиторий сайта.

  2. В репозитории перейдите к файлу _config.yml.

  3. В правом верхнем углу представления файла щелкните (Изменить файл), чтобы открыть редактор файлов.

    Снимок экрана: файл. В заголовке кнопка, помеченная значком карандаша, описывается темно-оранжевым цветом.

  4. Найдите строку, начинающуюся с markdown:, и измените значение с kramdown на GFM. Полная строка должна прочитать markdown: kramdown или markdown: GFM.

  5. Нажмите кнопку " Зафиксировать изменения" ...

  6. В поле "Фиксация сообщения" введите короткое понятное сообщение фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.

  7. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.

    Снимок экрана: запрос на вытягивание GitHub с переключателем для фиксации непосредственно в главной ветви или создания новой ветви. Выбрана новая ветвь.

  8. Нажмите кнопку Зафиксировать изменения или Предложить изменения.

Дополнительные материалы