Configurar un procesador Markdown para tu sitio de páginas de GitHub usando Jekyll

Puedes elegir un procesador Markdown para determinar la manera en que Markdown se representa en tu sitio de GitHub Pages.

¿Quién puede utilizar esta característica?

GitHub Pages se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server.

Nota:

Aunque esta gema github-pages sigue siendo compatible con algunos flujos de trabajo, GitHub Actions es ahora el enfoque recomendado para implementar y automatizar sitios de GitHub Pages.

Las personas con permisos de escritura para un repositorio pueden configurar el procesador Markdown para un sitio de GitHub Pages.

GitHub Pages admite dos procesadores de Markdown: kramdown y el propio procesador de Markdown de GitHub, que se usa para representar GitHub Flavored Markdown (GFM) desde GitHub. Para más información, consulta Acerca de escritura y formato en GitHub.

Puedes usar Markdown de tipo GitHub con cualquiera de los procesadores.

  1. En GitHub, navega al repositorio de tu sitio.

  2. En el repositorio, ve al archivo config.yml.

  3. En la esquina superior derecha de la vista de archivos, haz clic en para abrir el editor de archivos.

    Captura de pantalla de un archivo. En el encabezado, un botón (etiquetado con un icono de lápiz) está resaltado en naranja oscuro.

  4. Busque la línea que comienza por markdown: y cambie el valor a kramdown o GFM. La línea completa debe ser markdown: kramdown o markdown: GFM.

  5. Haga clic en Confirmar cambios.

  6. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, consulta Crear una confirmación con distintos autores.

  7. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, consulta Crear una solicitud de incorporación de cambios.

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un botón de radio para confirmar directamente en la rama principal o para crear una rama. Aparece seleccionada la opción de rama nueva.

  8. Haz clic en Confirmar cambios o Proponer cambios.

Información adicional