Skip to main content
Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Crear y resaltar bloques de código

Compartir muestras de código con bloques de código cercados y habilitar el resaltado de la sintaxis

Bloques de código cercados

Puedes crear bloques de código cercados al colocar comillas simples triples ``` antes y después del bloque de código. Te recomendamos dejar una línea en blanco antes y después de los bloques de código para facilitar la lectura del formato sin procesar.

```
function test() {
  console.log("notice the blank line before this function?");
}
```

Bloque de código cercado representado

Sugerencia: Para preservar tu formato en una lista, asegúrate de dejar una sangría de ocho espacios para los bloques de código no cercados.

Para mostrar las comillas simples triples en un bloque de código cercado, enciérralas en comillas simples cuádruples.

````
```
Look! Puedes ver mis comillas inversas.
```
````

Código cercado interpretado con un bloque de comillas inversas

Si editas fragmentos de código y tablas frecuentemente, podrías beneficiarte de habilitar una fuente de ancho fijo en todos los campos de comentario en GitHub Enterprise Cloud. Para obtener más información, consulta la sección "Habilitar fuentes de ancho fijo en el editor".

Resaltado de la sintaxis

Puedes agregar un identificador opcional de idioma para habilitar el resaltado de la sintaxis en tu bloque de código cercado.

Por ejemplo, para resaltar la sintaxis del código Ruby:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
puts markdown.to_html
```

Bloque de código cercado representado con sintaxis de Ruby resaltada

Usamos Lingüista para realizar la detección del idioma y seleccionar gramáticas independientes para el resaltado de la sintaxis. Puedes conocer las palabra clave válidas en el archivo YAML de idiomas.

Crear diagramas

También puedes usar bloques de código para crear diagramas en el lenguaje de marcado. GitHub es compatible con la sintaxis de Mermaid, geoJSON, topoJSON y ASCII STL. Para obtener más información, consulta la sección "Crear diagramas".

Leer más