Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Настройка обработчика 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.

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

GitHub Pages поддерживает два обработчика Markdown: kramdown и собственный обработчик Markdown GitHub, который используется для отрисовки GitHub Flavored Markdown (GFM) в GitHub. Дополнительные сведения см. в разделе Сведения о написании и форматировании в GitHub.

GitHub Flavored Markdown поддерживает оба обработчика, но полное соответствие результатам, отображаемым в GitHub, обеспечивает только наш обработчик GFM.

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

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

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

    Кнопка "Изменить файл"

    Примечание. Вместо редактирования и фиксации файла с помощью редактора файлов по умолчанию можно использовать редактор кода github.dev. Для этого щелкните раскрывающееся меню рядом с и нажмите Открыть в github.dev.

    Раскрывающееся меню "Изменить файл"

  4. Найдите строку, начинающуюся с markdown:, и измените значение с kramdown на GFM. Настройка Markdown в файле config.yml 1. В нижней части страницы введите короткое понятное сообщение о фиксации, описывающее внесенное в файл изменение. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими соавторами. Сообщение о фиксации для изменения

  5. Если у вас есть несколько адресов электронной почты, связанных с вашей учетной записью в GitHub.com, щелкните раскрывающееся меню адрес электронной почты и выберите адрес электронной почты, который будет использоваться в качестве адреса электронной почты автора Git. В этом раскрывающемся меню отображаются только проверенные адреса электронной почты. Если вы включили сохранение конфиденциальности адресов электронной почты, то по умолчанию используется адрес электронной почты автора фиксации <username>@users.noreply.github.com. Дополнительные сведения см. в разделе Настройка адреса электронной почты для фиксации. Выбор адресов электронной почты для фиксаций 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание нового запроса на вытягивание. Параметры фиксации ветви 1. Щелкните Предложить новый файл Кнопка "Предложить новый файл"

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