¿Cómo escapar de un carácter de tubería en una declaración de código en una tabla de rebajas?

100

En GitHub quiero crear una tabla que contenga fragmentos de código en Markdown. Funciona bien, excepto cuando pongo un carácter de tubería (es decir, |) entre los caracteres de tilde (es decir, `).

Esto es lo que quiero:

      a     |  r  
------------|-----
 `a += x;`  |  r1
 `a |= y;`  |  r2

El problema es que la barra vertical en la declaración de código de la segunda línea se interpreta como un delimitador de columna. Entonces, la representación de la tabla se ve bastante fea. ¿Cómo podría evitar eso?

Tenga en cuenta que ya intenté usar el |código HTML, pero produce a |= y;.

github escaping pipe markdown Marc de Verdelhan
fuente

Respuestas:

143

A partir de marzo de 2017, el uso de tuberías de escape es mucho más fácil: \|consulte otras respuestas.

Si quita las comillas invertidas ( ` ), usar el |truco funciona

      a     |  r  
------------|-----
 `a += x;`  |  r1
 a |= y;  |  r2

y produce la siguiente salida

ingrese la descripción de la imagen aquí

Alternativamente, puede reemplazar las comillas invertidas ( ` ) con un <code></code>marcado que corrige los problemas de manera más agradable al preservar la representación

      a     |  r  
------------|-----
 `a += x;`  |  r1
<code>a &#124;= y;</code>  |  r2

generando la siguiente salida

ingrese la descripción de la imagen aquí

nulltoken
fuente
4
Sí, ¡funcionó usando <code></code>marcado! Muchas gracias.
Marc de Verdelhan
Bitbucket no permite <code>-bloques: - / ¿hay otra posibilidad?
Sergej
2
En GitHub, el escape Markdown \|funciona. La gente pasa a HTML demasiado rápido sin intentar escapar de la rebaja.
jnm2
A partir de marzo de 2019, en Gitlab Wikis, aún debe usar " &#124;" dentro del código de marcado.
knb
Aún no es compatible con Bitbucket, consulte bitbucket.org/site/master/issues/17106/…
Lorenzo Solano
19

A mediados de 2017, la tubería simplemente puede escaparse con una barra invertida, así: \|

Esto funciona tanto dentro como fuera de las comillas inversas.

El código HTML ahora también se puede usar nuevamente, pero solo fuera de las comillas invertidas.

Respuesta anterior:

En marzo de 2017, la respuesta aceptada dejó de funcionar porque GitHub cambió su analizador de rebajas . Usar otro símbolo Unicode que se parezca a una tubería parece ser la única opción en este momento, por ejemplo:

ǀ (U + 01C0, clic dental en letra latina)

∣ (U + 2223, el símbolo se divide)

⎮ (U + 23AE, Extensión integral)

Janosch
fuente
2
La respuesta aceptada parece funcionar bien para mí en GitHub, tanto en un Gist como en la solicitud de extracción que envié.
Iiridayn