Skip to main content

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.

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. Para más información, vea "Productos de GitHub".

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 Enterprise Cloud. Para más información, vea "Acerca de la escritura y el formato en GitHub".

Puedes utilizar el Lenguaje de Marcado Enriquecido de GitHub con cualquier procesador, pero solo tu procesador de GFM empatará siempre con los resultados que ves en GitHub Enterprise Cloud.

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

  2. En el repositorio, vaya hasta el archivo _config.yml.

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

    Botón Edit file

    Nota: En lugar de editar y confirmar el archivo con el editor de archivos predeterminado, puedes optar por usar el editor de código github.dev; para ello, haz clic en el menú desplegable situado junto a y selecciona Abrir en github.dev.

    Menú desplegable del botón Editar archivo

  4. Busque la línea que comienza por markdown: y cambie el valor a kramdown o GFM. Configuración de Markdown en config.yml 1. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio

  5. Si tiene más de una dirección de correo electrónico asociada a la cuenta en GitHub.com, haga clic en el menú desplegable de la dirección de correo electrónico y seleccione la que se usará como dirección de correo electrónico del creador de Git. Únicamente las direcciones de correo electrónico verificadas aparecen en el menú desplegable. Si ha habilitado la privacidad de la dirección de correo electrónico, <username>@users.noreply.github.com es la dirección de correo electrónico predeterminada del creador de la confirmación. Para más información, vea "Configuración de la dirección de correo electrónico de confirmación". Elección de direcciones de correo electrónico para confirmaciones 1. 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, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama 1. Haga clic en Proponer nuevo archivo. Botón para proponer un nuevo archivo

Información adicional