Hay dos formas de formatear el código en Markdown. Puede usar código en línea, colocando comillas invertidas (`) alrededor de partes de una línea, o puede usar un bloque de código, al que algunos renderizadores aplicarán el resaltado de sintaxis.
Código en línea
Puede utilizar el formato de código en línea para enfatizar un pequeño comando o parte de la sintaxis dentro de una línea que está escribiendo.
Por ejemplo, es posible que desee mencionar el Array.protoype.map()
método de JavaScript . Al utilizar el formato de código en línea, está claro que se trata de un fragmento de código. También puede usarlo para ilustrar un comando de terminal, como yarn install
.
Para usar el formato de código en línea, simplemente envuelva el código que desea formatear con comillas invertidas. En un teclado QWERTY de diseño estándar de EE. UU., Se puede encontrar a la izquierda de '1' y encima de la tecla Tab. A continuación, se proporciona más información sobre la ubicación de la comilla invertida en teclados internacionales.
Por ejemplo, escribir `Array.prototype.map ()` en markdown se representará como Array.prototype.map()
.
Bloques de código
Para escribir fragmentos de código más largos o más detallados, a menudo es mejor colocarlos dentro de un bloque de código. Los bloques de código le permiten usar varias líneas, y Markdown lo representará dentro de su propio cuadro y con la fuente del tipo de código.
Para lograr esto, comience su bloque con una línea de tres comillas invertidas. Esto le indica a Markdown que está creando un bloque de código. Deberá terminar con otra línea de tres comillas invertidas. Por ejemplo:
''
var add2 = function (number) {
devolver número + 2;
}
''
se representará en markdown como:
var add2 = function(number) { return number + 2; }
Resaltado de sintaxis
Si bien no es compatible de forma nativa con Markdown, muchos motores de Markdown, incluido el que usa GitHub, admitirán el resaltado de sintaxis. Esto significa que al decirle a Markdown qué lenguaje está usando dentro del bloque de código, agregará colores como lo haría un IDE.
Puede hacer esto agregando el nombre del idioma en la misma línea que sus tres tics de apertura. En el ejemplo anterior, si en lugar de que la primera línea sea `` '' podría escribir `` `js, se aplicará el resaltado de JavaScript al bloque.
var add2 = function(number) { return number + 2; }
Sin embargo, el resaltado de sintaxis se puede aplicar a más que solo JavaScript. Puede usar `` `html:
Hello World
`` rubí:
"Hello World".split('').each do |letter| puts letter end
o `` pitón:
a, b = 0, 1 while b < 10: print(b) a, b = a, a + b
Solo recuerde, no todos los motores de rebajas aplicarán el resaltado de sintaxis.
Ticks invertidos en teclados internacionales
La ubicación de la tecla de tilde puede ser diferente en diferentes teclados, y si no está usando un teclado QWERTY de distribución estadounidense, puede ser difícil de encontrar. Esta útil guía enumera algunas de las formas de encontrar la clave de tilde, que hemos recopilado aquí a continuación:
QWERTY y QWERTZ:

AZERTY:

