Original article: https://www.freecodecamp.org/news/how-to-format-code-in-markdown/

Hay dos maneras de dar formato al código en Markdown. Puedes usar código en línea, colocando comillas invertidas (`) alrededor de partes de una línea, o puedes usar un bloque de código al que algunos renderizadores le aplicarán un resaltado de sintaxis.

Código en línea

Puedes usar el formateo de código en línea para enfatizar un comando o una pieza pequeña de sintaxis dentro de una oración que estás escribiendo.

Por ejemplo, si quisieras mencionar el método Array.protoype.map() de JavaScript. Al utilizar el formato de código en línea, queda claro que se trata de una pieza de código. También podrías usarlo para ilustrar un comando de la terminal como yarn install.

Para utilizar el formato de código en línea, simplemente pon entre comillas invertidas el código al que le quieres dar formato. En un teclado QWERTY estándar de EE.UU., esto se encuentra a la izquierda del ‘1’, y sobre la tecla Tab. Más información sobre la ubicación de las comillas invertidas en teclados internacionales es provista debajo.

Por ejemplo, escribir `Array.prototype.map()` en Markdown se va a renderizar como Array.prototype.map().

Bloques de código

Para escribir fragmentos de código más largos y detallados, habitualmente es mejor colocarlos dentro de un bloque de código. Los bloques de código le permiten utilizar múltiples líneas, y Markdown las renderizará dentro de su propio cuadro y con un tipo de fuente de código.

Para lograr esto, comience su bloque con una línea de tres comillas invertidas. Esto le señala a Markdown que está creando un bloque de código. Necesitará finalizarlo con otra línea de tres comillas invertidas. Por ejemplo:

```
var sumar2 = function(numero) {
  return numero + 2;
}
```

se renderizará en Markdown como:

var sumar2 = function(numero) {
  return numero + 2;
}

Resaltado de sintaxis

Aunque no es soportado nativamente por Markdown, varios motores de Markdown, incluyendo el que es utilizado por GitHub, soportarán el resaltado de sintaxis. Esto significa que al indicarle a Markdown el lenguaje que está utilizando dentro del bloque de código, este le agregará colores como lo haría un entorno de desarrollo integrado (IDE).

Puedes hacer esto agregando el nombre del lenguaje en la misma línea de sus tres comillas invertidas de apertura. En el ejemplo de arriba, si en lugar de que la primera línea sea ``` se escribiera ```js, entonces se aplicaría el resaltado de JavaScript al bloque.

var sumar2 = function(numero) {
	return numero + 2;
}

Sin embargo, el resaltado de sintaxis se puede aplicar a más que solo JavaScript. Puedes utilizar ```html:

<div class="row">
  <div class="col-md-6 col-md-offset-3">
    <h1>Hola Mundo</h1>
  </div>
</div>

```ruby:

"Hola Mundo".split('').each do |letter|
  puts letter
end

o ```python:

a, b = 0, 1
while b < 10:
    print(b)
    a, b = a, a + b

Solo recuerda, no todos los motores de Markdown aplicarán el resaltado de sintaxis.

Comillas invertidas en teclados internacionales

La ubicación de la tecla de comillas invertida puede variar en distintos teclados, y si no estás utilizando un teclado QWERTY de distribución estadounidense, puede ser difícil de encontrar. A continuación puedes ver -señalada en rojo- dónde encontrar la tecla de comillas invertida en distintos diseños de teclado:

QWERTY Latinoamericano:

image-12

QWERTY:

image-11

AZERTY:

8f65c339ce4eefd9d79841f3dc54f4c37cab2e77
de291f0895b0fed992726a62d654f4e1f0e421f3