Guía de formato

Nuevo Markdown al estilo de Reddit

El formato con el que se escribe el contenido de Reddit se llama Markdown. Esta es una guía para el estilo particular de Markdown usado en Reddit, ajustado para Nuevo Reddit, y actualizado con fecha 19 de septiembre de 2018.

Acerca de este documento

El contenido de texto de Reddit (comentarios, posts de texto y otros similares) se representa como una variación específica para Reddit del formato Markdown , y este formato ha cambiado en Nuevo Reddit, tanto en la sintaxis como en la presentación. Esta es una guía al Markdown al estilo de Reddit, que explica de forma general cómo dar formato al contenido en Nuevo Reddit, y específicamente identifica áreas en las que el Markdown al estilo de Nuevo Reddit difiere del Markdown al estilo Antiguo Reddit.

Los usuarios que únicamente publican contenido usando el  editor completo en Nuevo Reddit no entran en contacto con los detalles que se describen aquí. No se necesita saber nada de esta información para usar Reddit: El editor completo es un editor de texto enriquecido que proporciona todas las opciones de formato habituales como negrita, cursiva, listas, etc.

En esta guía se presentan ejemplos en pares,mostrando primero cómo se escribe el Markdown en el editor, y luego cómo se muestra en la pantalla. Las  notas importantes de Nuevo Reddit sobre las diferencias entre el Markdown estilo Nuevo Reddit y el Markdown estilo Antiguo Reddit se destacan con párrafos en cursiva y marcados con una bola de cristal (🔮), y los consejos generales se marcan con una flor de lis (⚜️).

Referencia rápida

Esta es una hoja de referencia con un resumen de la sintaxis habitual de Markdown. Lee más aparte de ella para obtener todos los detalles.

Escrito	Mostrado
_cursiva_ o *cursiva*	cursiva
__bold__ or **negrita**	negrita
___bold-italic___ or ***negrita y cursiva***	negrita-cursiva
~~tachado~~	tachado
>!spoilers!<	spoilers
^superíndice o ^(superíndice)	superíndice
`código`	código

Escrito	Mostrado
https://www.reddit.com	https://www.reddit.com
r/announcements	r/announcements
u/reddit	u/reddit

---

Escrito:

[enlace](https://redditinc.com)

o

[enlace][1]

[1]: https://redditinc.com

Mostrado:

enlace

---

Escrito:

# Encabezado 1
## Encabezado 2

Mostrado:

Encabezado 1

Encabezado 2

---

Escrito:

- a
- b
  1. c
  2. d

Mostrado:

• a
• b
  1. c
  2. d

---

Escrito:

> Lorem blockquote dolor sit amet, consectetur adipiscing elit.
> Sed ullamcorper enim libero, ut luctus lorem ultricies ut.
> Aenean sed nulla a mauris posuere aliquam bibendum id ipsum.
> Fusce non augue mollis, dictum libero sed, blockquote enim.

Mostrado:

Lorem blockquote dolor sit amet, consectetur adipiscing elit. Sed ullamcorper enim libero, ut luctus lorem ultricies ut. Aenean sed nulla a mauris posuere aliquam bibendum id ipsum. Fusce non augue mollis, dictum libero sed, blockquote enim.

---

Escrito:

| encabezado | encabezado | encabezado | encabezado |
|--------|:-------|-------:|:------:|
| cosas  | cosas  | cosas  | cosas  |

Mostrado:

encabezado	encabezado	encabezado	encabezado
cosas	cosas	cosas	cosas

---

Escrito (Poner atención a la sangría):

    fn main() {
        println!("hey")
    }

Mostrado:

fn main() {
    println!("hey")
}

Dónde usar Markdown en Reddit

El contenido Markdown puede publicarse en varios lugares en Reddit. Los principales usos de Markdown son los posts de texto (el cuerpo de un post de texto) y en comentarios.

Cuando se envía un post de texto o un comentario en Nuevo Reddit, de forma predeterminada se envía el contenido sin Markdown por medio del editor completo WYSIWYG (What You See Is What You Get), al menos en la versión de escritorio, puede ser distinto en la versiones para celular. Si en cambio haces clic en “Cambiar a Markdown” en la pantalla de envío del post, entonces estarás enviando contenido Markdown. Los usuarios pueden elegir el lenguaje Markdown en lugar del editor completo para tener más control sobre sus documentos, para usar algunas funciones no soportadas por el editor completo, o simplemente por preferencia.

Estos son otros lugares que admiten Markdown:

• Wikis: algunos subreddits tienen sus propias wikis, y hay una wiki para todo el sitio.
  • p.ej.: https://www.reddit.com/r/funny/wiki/index
  • p.ej.: https://www.reddit.com/wiki/faq
• El texto de envío en subreddits (el texto que se muestra en el Antiguo Reddit al enviar un post a un subreddit en particular).
• Barra lateral de “área de texto” de Nuevo Reddit.
• Reglas del subreddit: estas se muestran en algunos lugares, de manera más notable en la barra lateral, pero también en otras páginas.
  • p.ej., https://www.reddit.com/r/funny/about/rules
  • p.ej., https://www.reddit.com/r/funny/about/sidebar
• El texto "acerca de" en algunos perfiles de usuario en Nuevo Reddit: actualmente en beta (ya que es una función opcional).

Hay diferencias significativas en el soporte de estos últimos casos entre Antiguo Reddit y Nuevo Reddit, el editor de Markdown y el nuevo editor de Markdown. Para conocer los detalles, consulta "Diferencias en el soporte de contenido entre Antiguo Reddit y Nuevo Reddit"

Markdown con estilo Reddit

Párrafos y saltos de línea

Los párrafos  se escriben en Reddit como líneas de texto separadas por líneas en blanco.

Escrito:

En los remotos e inexplorados confines del arcaico extremo occidental de la espiral
de la galaxia, brilla un pequeño y despreciable sol amarillento.

En su órbita, a una distancia aproximada de ciento cincuenta millones de kilómetros, gira un pequeño
planeta totalmente insignificante de color azul verdoso cuyos pobladores,
descendientes de los simios, son tan asombrosamente primitivos que aún creen que
los relojes de lectura directa son de muy buen gusto.

Este planeta tiene, o mejor dicho, tenía el problema siguiente: la mayoría de
sus habitantes eran infelices durante casi todo el tiempo. Muchas soluciones
se sugirieron para tal problema, pero la mayor parte de ellas se referían principalmente a
los movimientos de pequeños trozos de papel verde; cosa extraña, ya que
los pequeños trozos de papel verde no eran precisamente quienes
se sentían infelices.

Mostrado:

Lejos, en los remansos inexplorados del extremo menos agradable del brazo espiral occidental de la galaxia, se encuentra un pequeño sol amarillo sin nada especial.

Orbitando a dicho sol a una distancia de aproximadamente ciento cincuenta millones de kilómetros hay un pequeño e insignificante planeta verde azulado cuyas formas de vida descendientes de los simios son tan asombrosamente primitivas que todavía piensan que los relojes digitales son una buena idea.

Este planeta tiene, o mejor dicho, tenía el problema siguiente: la mayoría de sus habitantes eran infelices durante casi todo el tiempo. Muchas soluciones se sugirieron para tal problema, pero la mayor parte de ellas se referían principalmente a los movimientos de pequeños trozos de papel verde; cosa extraña, ya que los pequeños trozos de papel verde no eran precisamente quienes se sentían infelices.

Observa que los saltos de línea no se muestran, es decir, las líneas adyacentes se unen para crear un único párrafo. Pueden agregarse saltos de línea explícitamente al finalizar las líneas con dos espacios o con una diagonal invertida (\).

Escrito (observa los espacios dobles al final de la primera línea):

El amor lo es todo.  
Nosotros sólo somos partes.

Mostrado:

El amor lo es todo.
Nosotros sólo somos partes.

Escrito Observa la posición y dirección de la diagonal):

Más allá de las ideas de lo que está mal\
y lo que está bien, hay un campo.\Ahí te espero.

Mostrado:

Más allá de las ideas de lo que está mal
y lo que está bien, hay un campo.
Ahí te espero.

🔮 Nota para Nuevo Reddit : Crear saltos de línea con diagonales invertidas sólo funciona en Nuevo Reddit. Aunque la diagonal invertida es más clara de leer y escribir que dos espacios, si necesitas compatibilidad con Antiguo Reddit usa dos espacios para crear tus saltos de línea.

Los párrafos se separan por cualquier cantidad de líneas en blanco, y esas líneas en blanco no se muestran; así que no se puede añadir una cantidad arbitraria de espacio entre párrafos simplemente añadiendo más líneas en blanco.

Escrito:

No te preocupes por nada.\
¡Piensa en quién creó el pensamiento!



¿Por qué te quedas en la cárcel\
cuando la puerta está tan abierta?

Mostrado:

No te preocupes por nada.
¡Piensa en quién creó el pensamiento!

¿Por qué te quedas en la cárcel
cuando la puerta está tan abierta?

⚜️ Consejo : un truco para insertar líneas en blanco es crear un párrafo que sólo contenga "espacios sin salto de línea" .

Escrito:

No te preocupes por nada.\
¡Piensa en quién creó el pensamiento!

 

¿Por qué te quedas en la cárcel\
cuando la puerta está tan abierta?

Mostrado:

No te preocupes por nada.
¡Piensa en quién creó el pensamiento!

¿Por qué te quedas en la cárcel
cuando la puerta está tan abierta?

Ese   es una especie de entidad HTML que es útil para diversos "trucos" en Markdown.

Formato de texto básico

El texto en cursiva se representa rodeando el texto con un solo asterisco (*) o un guión bajo (_).

Escrito:

Es sólo el *error*, y no la _verdad_, lo que se niega a ser cuestionado.

Mostrado:

Es sólo el error , y no la verdad, lo que se niega a ser cuestionado.

El texto en negrita se representa rodeando el texto con un doble asterisco (**) o un doble guión bajo (__).

Escrito:

Es solo el **error**, y no la __verdad__, lo que se niega a ser cuestionado.

Mostrado:

Es sólo el error , y no la verdad, lo que se niega a ser cuestionado.

El texto en negrita y cursiva se representa rodeando el texto con un triple asterisco (***) o un triple guión bajo (___).

Escrito:

Es solo el ***error***, y no la ___verdad___, lo que se niega a ser cuestionado.

Mostrado:

Es sólo el error, y no la verdad, lo que se niega a ser cuestionado.

Los ejemplos anteriores resaltaron una sola palabra, pero el resalte también puede abarcar varias palabras.

Observa que en los ejemplos anteriores las palabras resaltadas estaban completamente rodeadas con asteriscos o guiones bajos. También es posible resaltar solo partes de palabras, pero sólo con asteriscos.

Escrito:

Esto es totalmente sub*der*ma*toglí**fico.

Mostrado:

Esto es totalmente subdermatoglífico.

El texto tachado se representa rodeando el texto con doble virgulilla (~~).

Escrito:

Lo mejor que aprenderás es simplemente a
~~amar~~ arrivotar y que ~~te amen~~ te arrivoten a cambio.

Mostrado:

Lo mejor que aprenderás es simplemente a amar arrivotar y que te  amen arrivoten a cambio.

Los spoilers pueden ocultarse como texto del spoiler rodeando el texto con >! y !<.

Escrito:

Lo mejor que aprenderás es simplemente a >!arrivotar y que te arrivoten a cambio!<.

Mostrado:

Lo mejor que aprenderás es simplemente a arrivotar y que te arrivoten a cambio.

El texto en superíndice se representa colocando el texto entre paréntesis precedido por un acento circunflejo (^).

Escrito:

Lo mejor que aprenderás es simplemente a
arrivotar ^(y que te arrivoten a cambio).

Mostrado:

Lo mejor que aprenderás es simplemente a arrivotar ^{y que te arrivoten a cambio}.

Una sola palabra puede también escribirse como superíndice al escribir un acento circunflejo antes de ella.

Escrito:

Lo mejor que aprenderás es simplemente a
^arrivotar y que te ^arrivoten a cambio.

Mostrado:

Lo mejor que aprenderás es simplemente a ^arrivotar y que te ^arrivoten a cambio.

🔮 Nota para Nuevo Reddit: Hay diferencias significativas al mostrar superíndices entre Antiguo Reddit y Nuevo Reddit. En particular, Antiguo Reddit a veces no muestra la forma entre paréntesis si contiene enlaces (como ^(a [b](http://example.com)) ). Nuevo Reddit no admite (todavía) múltiples niveles de superíndice. Y hay errores de funcionamiento. En ambos. Para lograr la máxima compatibilidad de superíndices entre Antiguo y Nuevo Reddit, aconsejamos usar la sintaxis de superíndices en cada palabra, sin paréntesis, o alternativamente separar las palabras con elementos HTML como "espacio sin salto de línea" ( ) o "espacio de un cuarto de ancho" ( ) (este último permite saltos de línea en el superíndice).

Escrito:

Lo mejor que aprenderás es simplemente a
arrivotar y ^que ^te ^arrivoten ^a ^cambio.

Mostrado:

Lo mejor que aprenderás es simplemente a arrivotar y  ^{que te arrivoten a cambio.}

Escrito:

Lo mejor que aprenderás es simplemente a
arrivotar ^y que te arrivoten a cambio.

Mostrado:

Lo mejor que aprenderás es simplemente a arrivotar ^{y que te arrivoten a cambio.}

Y si tu texto en superíndice contiene enlaces, el superíndice también puede aplicar al enlace.

Escrito:

Lo mejor que aprenderás es simplemente a
arrivotar ^y que [^te ^arrivoten](https://www.redditgifts.com) ^a ^cambio.

Mostrado:

Lo mejor que aprenderás es simplemente a arrivotar y ^{que te arrivoten a cambio.}

Enlaces

Las URLs que comienzan con "http://" o "https://" se convierten automáticamente hipervínculos, al igual que los subreddits y nombres de usuario. Estos últimos se conocen como redditlinks y userlinks, respectivamente. Y en conjunto, se los conoce como autoenlaces.

Escrito	Mostrado
http://www.reddit.com	http://www.reddit.com
https://www.reddit.com	https://www.reddit.com
/r/announcements	/r/announcements
r/announcements	r/announcements
/u/reddit	/u/reddit
u/reddit	u/reddit

⚜️ Tip: Algunas URLs complejas pueden tener resultados inesperados con los autoenlaces. Cuando encuentres una URL que no está funcionando correctamente, puedes probar a rodear el texto con signos de mayor y menor (<, >).

Escrito:

<http://ejemplo.com/foo/../bar..>

Mostrado:

http://ejemplo.com/foo/../bar..

El texto arbitrario se puede convertir en hipervínculos rodeándolo con corchetes, seguido de una URL entre paréntesis. El enlace puede tener de manera opcional un título, que normalmente es mostrado por el navegador cuando el usuario pasa el cursor por encima del enlace.

El título debe ir rodeado de comillas simples, dobles o paréntesis.

Escrito	Mostrado
[Rumi](https://en.wikipedia.org/wiki/Rumi)	Rumi
[Zappa](https://en.wikipedia.org/wiki/Frank_Zappa "Frank Zappa - Wikipedia")	Zappa
[Gandhi](https://en.wikipedia.org/wiki/Mahatma_Gandhi 'Mahatma Gandhi - Wikipedia')	Gandhi
[Twain](https://en.wikipedia.org/wiki/Mark_Twain (Mark Twain - Wikipedia))	Twain

🔮 Nota para Nuevo Reddit: Los títulos rodeados por paréntesis sólo son compatibles con Nuevo Reddit. Usa comillas para compatibilidad.

Los enlaces también pueden definirse como referencias, fuera del párrafo.

Escrito:

[Muy poco] hace falta para tener una vida feliz;
todo está dentro de ti, en tu [forma de pensar][ref].

[Muy poco]: https://www.reddit.com/r/Meditation/
[ref]: https://www.reddit.com/r/ChangeMyView/

Mostrado:

Muy poco hace falta para tener una vida feliz; todo está dentro de ti, en tu forma de pensar.

De manera predeterminada, el nombre de la referencia es el mismo que el texto entre corchetes, pero la referencia puede nombrarse explícitamente dentro de un segundo conjunto de corchetes, como en [forma de pensar][ref]. Al igual que los enlaces en línea, los enlaces de referencia pueden tener títulos.

⚜️ Consejo: los enlaces usados con referencias son especialmente útiles para organizar un texto con muchos enlaces.

Escrito:

En un lugar de [la Mancha][lm], de cuyo nombre no quiero
acordarme, no ha mucho tiempo que vivía un hidalgo de los de
[lanza] en astillero, [adarga antigua][as] [rocín flaco][rf]
y galgo corredor.

[lm]: https://en.wikipedia.org/wiki/La_Mancha
[lanza]: https://en.wikipedia.org/wiki/Holy_Lance "Holy Lance - Wikipedia"
[as]: http://myarmoury.com/feature_shield.html 'The Shield: An Abridged History of its Use and Development'
[rf]: https://en.wikipedia.org/wiki/Epona (Epona - Wikipedia)

Mostrado:

En un lugar de la Mancha de cuyo nombre no quiero acordarme, no ha mucho tiempo que vivía un hidalgo de los de lanza en astillero, adarga antigua rocín flaco  y galgo corredor.

⚜️ Tip: Nota: Los enlaces sólo pueden contener paréntesis si están balanceados, es decir, si por cada paréntesis que abre "(" hay un paréntesis que cierra ")". Para poner un enlace a una dirección con parántesis no balanceados, es necesario ponerle un escape  al paréntesis con una diagonal invertida ("\") o usar la sintaxis alternativa de enlaces, poniendo la dirección entre signos de mayor y menor, "<" y ">".

Escrito:

[Paréntesis](https://es.wikipedia.org/wiki/\()

Mostrado:

Paréntesis

Escrito:

[Paréntesis](<https://es.wikipedia.org/wiki/(>)

Mostrado:

Paréntesis

En Reddit, los enlaces generalmente deben incluir el encabezado URI, como "https://", así que en vez de escribir [a](www.example.com), escribe [a](https://www.example.com).

El conjunto completo de prefijos aceptados en las URL es "http://", "https://", "ftp://", "mailto:", "git://", "steam://", "irc://", "news://", "mumble://", "ssh://", "ircs://", "ts3server://", "/", "#".

Encabezados

Los encabezados de sección tienen seis niveles y se escriben precedidos de un signo de número (#).

Escrito:

# Domain

## Kingdom

### Phylum

#### Class

##### Order

###### Family

Mostrado:

Domain

Kingdom

Phylum

Class

Order

Familia

En los encabezados de nivel 1 y 2, también se puede subrayar el texto con “=” y “-”, respectivamente.

Escrito:

Domain
======

Kingdom
-------

Mostrado:

Domain

Kingdom

Listas

Las listas pueden ser sin orden (con viñetas) o con orden (numeradas).

Las listas sin orden están formadas por líneas precedidas por un "-" o un "*".

Escrito:

- Agamenón
- Los portadores de libación
- Las Euménides

Mostrado:

• Agamenón
• Los portadores de libación
• Las Euménides

Escrito:

* Agamenón
* Los portadores de libación
* Las Euménides

Mostrado:

• Agamenón
• Los portadores de libación
• Las Euménides

Las listas ordenadas están compuestas por líneas numeradas delimitadas por “.” o “)”.

Escrito:

1. Agamenón
2. Los portadores de libación
3) Las Euménides

Mostrado:

1. Agamenón
2. Los portadores de libación
3. Las Euménides

Escrito:

1) Agamenón
2) Los portadores de libación
3) Las Euménides

Mostrado:

1. Agamenón
2. Los portadores de libación
3. Las Euménides

🔮 Nota para Nuevo Reddit : El uso de ")" para definir listas ordenadas solo funciona en NuevoReddit. Para compatibilidad con Antiguo Reddit, usa ".".

En Reddit, las listas ordenadas deben comenzar con “1”.

Excepto la numeración, las listas no ordenadas y las listas ordenadas se muestran en general de la misma forma, así que en los ejemplos restantes se utilizarán listas no ordenadas para simplificar.

Cada entrada individual en una lista se denomina elemento de la lista. Los elementos pueden tener cualquier cantidad de espacio entre ellos. Agregar más espacio puede hacer que los elementos de listas complejos sean más legibles al editar.

Escrito:

- Agamenón
- Los portadores de libación
- Las Euménides

Mostrado:

• Agamenón

• Los portadores de libación

• Las Euménides

Los elementos pueden contener sublistas.

Escrito:

- Homero
  - La Ilíada
  - La Odisea
- Esquilo
  - Agamenón
  - Los portadores de libación
  - Las Euménides

Mostrado:

• Homero
  • La Ilíada
  • La Odisea
• Esquilo
  • Agamenón
  • Los portadores de libación
  • Las Euménides

Ten en cuenta que las sublistas de elementos de listas no ordenadas deben ir precedidas de al menos dos espacios, mientras que las sublistas de elementos de listas ordenadas deben ir precedidas de al menos tres espacios.

Las listas pueden contener sus propios párrafos, citas en bloque y otros tipos de contenido.

Escrito:

- En primer lugar: Lorem ipsum dolor sit amet, consectetur adipiscing
elit.

  > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
 > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
 > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
 > pretium dui. Nam eget consequat eros, eget commodo urna.

- Pero en segundo lugar: Phasellus vitae libero sit amet orci tempor lacinia
 sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio
 sapien, et condimentum velit convallis et.

  ### Información sobre Lipsum

  |Lorem|Ipsum|Dolor|
  |-----|-----|-----|
  |8    |1    |3    |
  |3    |7    |8    |

  Aenean at dui in sapien sagittis sodales.

Mostrado:

• En primer lugar: Lorem ipsum dolor sit amet, consectetur adipiscing elit.

  Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

• Pero en segundo lugar: Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

  Información sobre Lipsum

  Lorem	Ipsum	Dolor
  8	1	3
  3	7	8

  Aenean at dui in sapien sagittis sodales.

🔮 Nota para Nuevo Reddit: En Markdown, incluso en Antiguo Reddit, + también se puede usar para definir listas no ordenadas. Al presente, Nuevo Reddit no puede mostrar esas listas.

Citas en bloque

Las citas en bloque son una forma de enfatizar grandes cantidades de texto, normalmente se usan en las respuestas a comentarios para citar los comentarios de otras personas. Se crean comenzando una línea con un signo mayor que (>).

Escrito:

> Es tan difícil olvidar el dolor, pero es aún más difícil
recordar la dulzura. No tenemos ninguna cicatriz que nos recuerde la felicidad.
Aprendemos muy poco de la paz.

Mostrado:

Es tan difícil olvidar el dolor, pero es aún más difícil recordar la dulzura. No tenemos ninguna cicatriz que nos recuerde la felicidad. Aprendemos muy poco de la paz.

Para las citas simples, basta con iniciar la primera línea de un párrafo con >, como se muestra anteriormente, y todo quedará citado en bloque.

Para citas en bloque más complejas, se debe poner > antes de cada línea.

Escrito:

> - En primer lugar: Lorem ipsum dolor sit amet, consectetur adipiscing
>   elit.
>
> - Pero en segundo lugar: Phasellus vitae libero sit amet orci tempor lacinia
>   sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio
>   sapien, et condimentum velit convallis et.
>
> > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
> > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
> > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
> > pretium dui. Nam eget consequat eros, eget commodo urna.
>
> ### Información sobre Lipsum
>
> |Lorem|Ipsum|Dolor|
> |-----|-----|-----|
> |8    |1    |3    |
> |3    |7    |8    |
>
> Aenean at dui in sapien sagittis sodales.

Mostrado:

• En primer lugar: Lorem ipsum dolor sit amet, consectetur adipiscing elit.

• Pero en segundo lugar: Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

Información sobre Lipsum

Lorem	Ipsum	Dolor
8	1	3
3	7	8

Aenean at dui in sapien sagittis sodales.

Tablas

Las tablas consisten en una fila de encabezado y una cantidad variable de filas de contenido. Las columnas se separan mediante barras verticales (|) y la fila de encabezado se separa de las filas de contenido mediante guiones (-).

Escrito:

| Criptomoneda | Inversión | Ganancia |
|--------|------------|--------|
| BTC    | $100       | $-50   |
| ETH    | $1000      | $-500  |
| DOGE   | $10000     | $-5000 |

Mostrado:

Criptomoneda	Inversión	Ganancia
BTC	$100	$-50
ETH	$1000	$-500
DOGE	$10000	$-5000

La segunda fila de la tabla, la que está llena de guiones, es la fila de formato y determina la alineación del texto en la columna. Las columnas de la fila de formato que comienzan con : están alineadas a la izquierda; las columnas que terminan con : están alineadas a la derecha; las columnas que comienzan y terminan con : están alineadas al centro; las columnas que contienen únicamente guiones están alineadas de manera predeterminada (a la izquierda).

Escrito:

| Criptomoneda | Inversión | Ganancia |
|:-------|-----------:|:------:|
| BTC    | $100       | $-50   |
| ETH    | $1000      | $-500  |
| DOGE   | $10000     | $-5000 |

Mostrado:

Criptomoneda	Inversión	Ganancia
BTC	$100	$-50
ETH	$1000	$-500
DOGE	$10000	$-5000

Afortunadamente, las columnas no necesitan tener formato con una alineación uniforme para que funcionen, pueden estar desordenadas.

Escrito:

| Ticker | Investment | Profit |
|:-|-:|:-:|
| BTC | $100 | $-50 |
| ETH | $1000 | $-500 |
| DOGE | $10000 | $-5000 |

Mostrado:

Criptomoneda	Inversión	Ganancia
BTC	$100	$-50
ETH	$1000	$-500
DOGE	$10000	$-5000

⚜️ Consejo: las tablas pueden escribirse sin las barras de comienzo y final de fila (|), pero esto puede dar resultados inesperados cuando al mostrarse se tiene que adivinar si la fila es una fila de la tabla u otra cosa. Poner las barras de comienzo y final de fila deja completamente claro que se está escribiendo una tabla.

Bloques de código y código en línea

Hay varias formas de representar el código en Markdown, que siempre se muestra en una fuente monoespaciada y se reproduce exactamente como está escrito, no se interpreta Markdown dentro de una región de código.

Los fragmentos de código breves, código en línea, pueden insertarse en párrafos y en otros textos, y están delimitados por acentos graves a ambos lados (` ).

Escrito:

Nos equivocamos: `goto`\
no se considera dañino;\
`goto` quiere ayudar.

Mostrado:

Nos equivocamos: goto
no se considera dañino;
goto quiere ayudar.

Los bloques de código más largos pueden representarse de varias maneras. La primera es dejar una sangría de cuatro espacios para todo el bloque de código.

Escrito:

    hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
    hashOut.length = SSL_SHA1_DIGEST_LEN;
    if ((err = SSLFreeBuffer(&hashCtx)) != 0)
        goto fail;
    if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
    if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
        goto fail;

Mostrado:

hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
    hashOut.length = SSL_SHA1_DIGEST_LEN;
    if ((err = SSLFreeBuffer(&hashCtx)) != 0)
        goto fail;
    if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
    if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
        goto fail;

🔮 Nota para Nuevo Reddit: La sangría es la única forma como los bloques de código funcionan en Antiguo Reddit. Es necesario usarlas si se busca mantener compatibilidad.

Escribir cuatro espacios delante de cada línea de un bloque de código es aburrido y es fácil cometer errores. La forma más fácil es rodear todo el bloque de código con delimitadores de código. Un delimitador de código es una línea que comienza con tres o más acentos graves (`) o tres o más virgulillas (~).

Escrito:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mostrado:

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

Escrito:

~~~
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
~~~

Mostrado:

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

El delimitador de apertura y de cierre deben coincidir tanto en el carácter utilizado como en el número de repeticiones.

⚜️ Sugerencia : cuando el código en línea en sí mismo contiene un acento grave, o un bloque de código delimitado en sí mismo contiene un delimitador de código, estos caracteres pueden hacer que la región del código se cierre antes de tiempo. En estos casos, los delimitadores se pueden ajustar para adaptarse al código. El resto de esta sección trata sobre esos casos especiales.

Considera el siguiente ejemplo.

Escrito:

```

Este código no funcionó como se esperaba:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Pero al menos lo intentó.

```

Mostrado:

Este código no funcionó como se esperaba:

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0) goto fail; goto fail;

Pero al menos lo intentó.

Aquí hay un delimitador de código dentro de un delimitador de código (es decir, un bloque de código Markdown que contiene un ejemplo de Markdown), y no se muestra de la manera deseada: el código dentro del delimitador de código interno no se muestra como código. En su lugar, el código aparece como texto normal rodeado de dos bloques de código.

Este es un problema fácil de resolver porque la sintaxis del delimitador de código tiene dos delimitadores diferentes, (`) y (~), y permite que los bloques de código estén rodeados por más de tres delimitadores. Simplemente se puede usar más acentos graves en el delimitador de código exterior o usar el otro carácter delimitador.

Escrito:

````

Este código no funcionó como se esperaba:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Pero al menos lo intentó.

````

Mostrado:

Este código no funcionó como se esperaba:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Pero al menos lo intentó.

Escrito:

~~~

Este código no funcionó como se esperaba:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Pero al menos lo intentó.

~~~

Mostrado:

Este código no funcionó como se esperaba:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Pero al menos lo intentó.

También existe un truco similar para el código en línea: el código en línea puede estar rodeado por cualquier cantidad de acentos graves, y la apertura y el cierre deben coincidir. Así que si se necesita poner un acento grave dentro del código en línea, se puede simplemente rodear el código con dos acentos graves, por ejemplo `esto de aquí, `, eso es un acento grave``.

Por supuesto, hay un caso más complicado: ¿qué ocurre si el propio código en línea debe comenzar o terminar con un acento grave, por ejemplo si quieres demostrar cómo escribir código en línea Markdown dentro del código en línea? Escribir dos acentos graves para abrir el código en línea y un acento grave para comenzar el texto del código en línea que se quiere demostrar no funciona, porque la sintaxis equivale a un código en línea delimitado por tres acentos graves: ```ejemplo de código en línea```. Si sólo escribes eso, los acentos graves al interior se pierden:

Escrito	Mostrado
```ejemplo de código en línea```	ejemplo de código en línea

Markdown ofrece una última solución para estas situaciones: todos los espacios alrededor del código en línea se eliminan, lo que permite escribir los delimitadores del código en línea, el espacio y, a continuación, el acento grave en el texto:

Escrito	Mostrado
`` `ejemplo de código en línea` ``	`ejemplo de código en línea`

Esta situación se da con mayor frecuencia en personas que usan Markdown para escribir sobre Markdown (¡como yo!). Espero que no pases por esto.

Por último, ¿Qué pasa si resulta que quieres espacios iniciales o finales en tu código en línea? Bueno, aquí las cosas se complican más. Si te encuentras en esta situación, probablemente tengas el suficiente ingenio para encontrar la forma.

Saltos temáticos

Los cambios de sección, también conocidos como “reglas horizontales”, son simplemente líneas horizontales que atraviesan la página. Se pueden usar para crear una separación visual en el contenido. Un cambio de sección se escribe como una línea que contiene tres o más asteriscos (*), guiones (-), o guiones bajos (_).

Escrito:

Esta es una historia nostálgica sobre mi abuelo.

---

Aquí hay una foto de un burro con sueño.

Mostrado:

Esta es una historia nostálgica sobre mi abuelo.

---

Aquí hay una foto de un burro con sueño.

Escrito:

Aquí hay un loro yéndose de fiesta.

***

Aquí hay engaño, decadencia y, en última instancia, muerte.

Mostrado:

Aquí hay un loro yéndose de fiesta.

---

Aquí hay engaño, decadencia y, en última instancia, muerte.

Escrito:

Esta es una puerta de granero oxidada.

___

Café negro.

Mostrado:

Esta es una puerta de granero oxidada.

---

Café negro.

Más consejos y trucos

Escapes en la sintaxis de Markdown

Los escapes son una forma de indicar que no se interpreten los caracteres especiales como Markdown, y se hace poniendo una diagonal invertida (\) antes del carácter que se quiere escapar.

A veces uno se encuentra con que el texto no es interpretado y mostrado como uno esperaba. Esto puede ocurrir, por ejemplo, si un guión inicia una nueva línea en medio de un párrafo.

Escrito:

Sentí que los pulmones se me inflaban con la avalancha de paisajes
- el aire, las montañas, los árboles, la gente. Pensé:
"Así es como se siente la felicidad".

Mostrado:

Sentí que los pulmones se me inflaban con la avalancha de paisajes

• el aire, las montañas, los árboles, la gente. Pensé: "Así es como se siente la felicidad".

En este caso, el guión es parte del texto, no el comienzo de una lista. Escapar al guión con una diagonal invertida soluciona el problema.

Escrito:

Sentí que los pulmones se me inflaban con la avalancha de paisajes
\ - el aire, las montañas, los árboles, la gente. Pensé:
"Así es como se siente la felicidad".

Mostrado:

Sentí que los pulmones se me inflaban con la avalancha de paisajes: el aire, las montañas, los árboles, la gente. Pensé: "Así es como se siente la felicidad".

Otro caso habitual en el que los escapes son necesarios es cuando hay paréntesis en un enlace.

Escrito:

[Paréntesis](https://en.wikipedia.org/wiki/))

Mostrado:

Paréntesis)

Se supone que esto es un enlace al artículo de Wikipedia sobre paréntesis (" https://es.wikipedia.org/wiki/) "), pero en su lugar es un enlace a "https://es.wikipedia.org/wiki/". Ponerle un escape al paréntesis en la URL hace que al mostrarlo no se le trate como el paréntesis de cierre de la sintaxis del enlace.

[Paréntesis](https://es.wikipedia.org/wiki/\))

Mostrado:

Paréntesis

Elementos de HTML

Markdown admite elementos de HTML, como el   (relativamente habitual) para el "espacio sin romper líneas". Estos pueden usarse como una solución para escribir contenido difícil de representar. Por ejemplo,   se usa a menudo para insertar párrafos “vacíos”, para generar espacio vertical en blanco donde Markdown no lo permite de ninguna otra manera.

En otros casos, los elementos HTML se usan para introducir caracteres difíciles de teclear, como los que están por encima del rango ASCII en Unicode, o caracteres que no tienen representación visual.

Algunos ejemplos útiles:

• Se inserta una raya con —. Se trata de un guión más largo que el típico guión, y en ocasiones puede usarse para separar frases en las oraciones.
• Se pueden utilizar varios caracteres de espacio en blanco no ASCII para insertar espacios en blanco donde Markdown no lo permite de otro modo. Si sólo quieres introducir una cantidad arbitraria de espacio entre dos palabras, puedes hacerlo, por ejemplo, insertando varios caracteres de “espacio largo” ( ).

Consejos para robots

Durante la transición hemos visto surgir algunas incompatibilidades en la sintaxis que usaban los bots. Estas son algunas notas de esas experiencias, así como información general sobre la publicación automática de Markdown.

(Anuncio rápido: ¡a esta sección le vendría bien la ayuda de gente que crea y usa bots!)

• En enlaces, no pongas espacios entre el texto ([...]) y la URL ((http://ejemplo.com)). Esto funcionaba en Antiguo Reddit pero no funciona en Nuevo Reddit.

• Escapa con diagonales invertidas todos los paréntesis en las URL de enlaces (no de autoenlaces), como, por ejemplo [texto](http://example.com/foo\(bar). Los paréntesis necesitan estar equilibrados o no se procesarán como enlaces, así que es suficiente con escapar todos los paréntesis dentro del enlace para que todos los enlaces con paréntesis se procesen correctamente.

• Como alternativa, para URL de enlaces usa la sintaxis con los signos menor que y mayor que ([text](<http://example.com>), que acepta paréntesis no equilibrados. Si haces esto, necesitas escapar todos los signos mayor que y menor que en las URL, como %3C and %3E.

• Si publicas autoenlaces (URL sin procesar y sin la sintaxis con paréntesis), considera rodearlos de los signos menor que y mayor que (< >) y escapar todos los signos menor que y mayor que que haya dentro de la URL como %3C and %3E. Esto impedirá que exista cualquier ambigüedad en el procesamiento, especialmente al final de los autoenlaces. Recuerda que no puede haber espacios entre los paréntesis en los autoenlaces, así que necesitas escaparlos en las URLs como %20.

• Simplemente no hay manera de evitar tener que ponerle escapes a algo si se usa un bot para publicar enlaces, si se quieres que todas las URL sean mostradas correctamente. Los detalles de cómo se muestran los enlaces se encuentran en las especificaciones.

• Las formas de mostrar nueva y antigua tratan de forma diferente los escapes de HTML (como  ): la antigua los conserva, tanto en el texto como en los enlaces; la nueva los ignora al mostrarlos para que los clientes (muchos de los cuales no son navegadores web) no tengan contacto con ellos. Esto sucede tanto en el texto como en los enlaces, y así lo especifica CommonMark. No entendemos el impacto de esto en los bots ni tenemos ninguna recomendación en este momento.

• Si existe la posibilidad de que tu superíndice contenga enlaces, escríbelos poniendo en superíndice cada palabra o separando las palabras en superíndice con un "espacio de un cuarto de ancho". La sintaxis más sencilla ^(...) no es confiable en Antiguo Reddit cuando se combina con enlaces.

Recomendaciones de compatibilidad para Markdown estilo Reddit

Estas son algunas recomendaciones para escribir Markdown que sea compatible con la forma de mostrarlo del Antiguo Reddit (siempre y cuando siga en uso).

Algunas de las recomendaciones son “sencillas” porque tienen equivalentes que son iguales de buenos en el Antiguo Reddit; otras son “desafortunadas” porque, bueno, favorecen una sintaxis más impráctica.

Podemos suponer que la antigua forma de mostrar Markdown se eliminará por completo en algún momento (en este momento solo se usa en el antiguo cliente web; los clientes móviles utilizan el nuevo), y en ese momento estas recomendaciones podrían cambiar.

Por otro lado, si no te importa el formato en el Antiguo Reddit, ¡haz lo contrario de todas estas sugerencias!

Recomendaciones de compatibilidad sencillas

• Usa comillas para los títulos de los enlaces, como [texto](http://ejemplo.com "título") (en lugar de paréntesis para los títulos de los enlaces). El Antiguo Reddit no admite paréntesis para esto.

• Inicia y termina las columnas de las tablas con barras verticales (|). Técnicamente son opcionales, pero en ocasiones no usarlas puede dar resultados inesperados. Tanto Antiguo Reddit como Nuevo Reddit tienen sus propias peculiaridades.

• Delimita las listas ordenadas con puntos en lugar de paréntesis, p. ej., (1. Primero) Antiguo Reddit no admite los paréntesis.

• Delimita las listas no ordenadas con - o *, no con +. Por el momento Nuevo Reddit no admite estos últimos.

Recomendaciones de compatibilidad desafortunadas

• Usa espacios dobles en lugar de diagonales invertidas para indicar los saltos de línea. Antiguo Reddit solo admite espacios dobles.

• Usa bloques de código con sangrías en lugar de delimitadores de código. Antiguo Reddit solo admite bloques de código con sangrías.

• No uses énfasis anidados como _esto es __muy__ importante_. Sí, adivinaste: no funciona en Reddit Antiguo.

• No uses varios niveles de superíndice (también conocido como "torres"). No funciona en Nuevo Reddit (al menos todavía no).

• Continúa usando los trucos más comunes para hacer que los superíndices admitan espacios, por ejemplo, escribe cada palabra como superíndice o únela con caracteres de espacio no convencionales de Unicode (ya sea   o ​). Evita la sintaxis de superíndice con paréntesis ^(...), ya que suele procesarse de forma incorrecta en Reddit Antiguo.

Más información sobre Markdown en Reddit

El nuevo procesador Markdown de Reddit, snoomark, es una variación de Markdown estilo GitHub (GFM) basada en CommonMark, con las extensiones de tabla y autoenlace de GFM, así como una extensión de tachado modificada. También incluye extensiones específicas de Reddit y algunas funcionalidades de compatibilidad específicas de Reddit que se alejan de CommonMark.

Snoomark es un proyecto derivado de comrak, que a su vez es una reimplementación de cmark-gfm, la implementación de CommonMark de GitHub con extensiones de GitHub (GFM), que a su vez deriva de cmark, la implementación de referencia de CommonMark. Snoomark en sí mismo no es (todavía) de código abierto, pero los cambios en comrak se integran regularmente en snoomark.

A medida que más Redditors han comenzado a utilizar las herramientas de creación y formato de posts en el Nuevo Reddit, la filosofía en torno a la compatibilidad con Markdown ha fluctuado. Originalmente, el plan era pasar a algo parecido a CommonMark y dejar de lado toda la compatibilidad con las “peculiaridades” de Antiguo Reddit; pero a medida que el despliegue avanzaba esa postura se suavizó, y se añadieron una serie de funcionalidades de compatibilidad en el procesador para mostrar el Markdown.

En este momento no se espera que se añadan muchas más características de compatibilidad a Nuevo Reddit: es más probable que Reddit Antiguo se actualice al nuevo procesador. En ese caso, habrá una cierta cantidad (pequeña, esperamos) de contenido antiguo que no se muestre correctamente por las diferencias al procesarlo.

Dicho esto, las direcciones futuras se seguirán evaluando a medida que los cambios continúen y los errores se reporten.

El procesamiento de Markdown en Nuevo Reddit es bastante diferente de Reddit Antiguo y de la mayoría de los sitios web que usan Markdown, porque no se muestra directamente en HTML a partir de Markdown, sino a través de un formato de documento intermedio propietario usado por Reddit, llamado “RTJSON” (“Texto enriquecido JSON”). Este formato está diseñado para ser fácilmente usado y mostrado por todos los clientes de Reddit, en versiones de escritorio y móvil, mientras que en Reddit Antiguo los clientes móviles tenían varios problemas para mostrar el contenido en Markdown de forma consistente. Hasta ahora no se han publicado los detalles del formato RTJSON.

Justificación de la transición a CommonMark

El nuevo procesador se creó porque el antiguo era difícil de mantener, el código C podía tener problemas de seguridad y era demasiado difícil añadirle nuevas funciones. El nuevo procesador no está escrito en C, por lo que es más fácil de mantener. Además, el nuevo diseño requería nuevas funciones y la posibilidad de añadir otras en el futuro.

El ritmo de desarrollo del antiguo procesador era efectivamente 0. El nuevo procesador recibe cambios conforme se necesiten, y la mayoría de ellos no requieren una revisión de seguridad.

El nuevo diseño fue también una oportunidad para actualizar el antiguo dialecto Markdown de Reddit a un dialecto CommonMark moderno y basado en estándares, en el que se pueden obtener los beneficios continuos del desarrollo de Markdown y de los avances en estándares, y para ponerse al día con aproximadamente 6 años de evolución de Markdown (mientras que el procesador de Reddit Antiguo estaba estancado). Esta decisión, por supuesto, dio lugar a muchas quejas de que ciertas sintaxis de Reddit Antiguo no funcionan en Nuevo Reddit, pero hemos añadido gradualmente la compatibilidad con versiones anteriores para las características más comunes.

El Markdown de Nuevo Reddit recibe además varias novedades heredadas de CommonMark, entre las que destacan los saltos de línea con barra invertida final y los bloques de código indicados con delimitadores en lugar de sangrías. Durante el período de transición, por supuesto que estas no serán compatibles con Reddit Antiguo, pero, eventualmente, esperamos que sean “seguras” para usar sin preocuparnos demasiado por la compatibilidad. Los clientes móviles ya entienden los resultados del nuevo procesador. Solo el antiguo cliente web no lo entiende (todavía).

Probablemente, la única alternativa seria a la actualización a CommonMark habría sido reescribir completamente el antiguo procesador en un lenguaje seguro, para conservar todas las características específicas de Reddit. Probablemente esto no se consideró deseable, tanto por la cantidad de trabajo necesaria como porque no le habría servido a nadie más que a Reddit. El nuevo procesador, por otra parte, se basa en un procesador de CommonMark mantenido de forma activa, que es útil para cualquiera que quiera procesar CommonMark. A largo plazo, adoptar un comportamiento más similar a CommonMark proporcionará una experiencia más fluida para quienes usen CommonMark en otros lugares, sobre todo los usuarios más técnicos, ya que la gran mayoría de los usuarios del Nuevo Reddit usan el editor completo. Ahora Reddit puede participar en la comunidad de origen de CommonMark (y ya ha afectado las implementaciones y la especificación de CommonMark). De nuevo, la combinación de una base de código que se pueda mantener y un estándar al que ajustarse permite a Reddit mantener su procesador actualizado a medida que los estándares evolucionan.

Diferencias entre el Markdown de Reddit Antiguo, el Markdown de Nuevo Reddit y CommonMark

El Markdown con el estilo de Nuevo Reddit hereda tanto del Markdown con el estilo de Reddit Antiguo como de CommonMark/GFM, pero también tiene diferencias con ambos. En esta sección, se mencionan las diferencias conocidas entre el Markdown con el estilo de Nuevo Reddit y el Markdown con el estilo de Reddit Antiguo y CommonMark/GFM. La lista no es exhaustiva.

Las diferencias con Reddit Antiguo suelen heredarse de CommonMark. Ten en cuenta que quienes quieran que su contenido se muestre con precisión para los usuarios de Reddit Antiguo pueden optar por no usar estas funciones. (También consulta las  Recomendaciones de compatibilidad para Markdown estilo Reddit). A menudo, las diferencias con CommonMark son para admitir las “peculiaridades” del Markdown de Reddit Antiguo. Las diferencias con respecto a cualquiera de los dos pueden o no considerarse errores, según quién las esté viendo y cuándo.

Extensiones específicas de Reddit

• Texto spoiler: el texto spoiler (>!spoiler!<) es específico de Reddit.

• Superíndice: no existe un estándar de superíndice. Reddit tiene su propia sintaxis, la cual sigue siendo compatible (^, ^(...)).

• Tachado: la sintaxis de Reddit es diferente de la extensión GFM.

• Enlaces de Reddit y de usuario: los nombres de los usuarios de Reddit y subreddits con los prefijos /r/, r/, /u/ y u/ se enlazan de forma automática.

• Medios de texto enriquecido: Reddit admite envíos que contengan imágenes, videos y GIFs, y estos se codifican en el Markdown con una sintaxis personalizada de imagen en línea. Esta función solo es compatible con el editor completo (al presente la sintaxis sería demasiado difícil de escribir manualmente).

• Los párrafos que sólo contienen espacio de ancho cero (​) son párrafos vacíos (el espacio de ancho cero se elimina al mostrarlos). Esto es compatible con el editor completo.

Nuevas funciones heredadas de CommonMark

• Las listas ordenadas pueden escribirse con paréntesis, mientras que en Reddit Antiguo sólo se admitían listas ordenadas con puntos (1) versus 1.).

• Se pueden escribir saltos de línea sin inicio de párrafo, terminando las líneas con \, mientras que en Reddit Antiguo sólo se podían escribir terminando las líneas con un espacio doble. Esta sintaxis es más legible y menos sorpresiva que la de espacio doble.

• Los bloques de código pueden marcarse con delimitadores en lugar de sangrías (``` o ~~~). Esta sintaxis es más popular, y probablemente más fácil de leer y escribir que la sintaxis con sangría.

Diferencias con del Markdown al estilo de Reddit Antiguo

• La sintaxis de superíndice entre paréntesis (^(super duper)) se procesa de forma más confiable (por ejemplo, los superíndices que contienen enlaces funcionan correctamente), y cuando se elimine el antiguo procesador debería usarse con preferencia sobre la sintaxis sin paréntesis. (^super).

• El superíndice se procesa de forma ligeramente diferente en los casos extremos, por ejemplo, ^(^b).

• Los superíndices anidados en varios niveles se muestran como un solo nivel de superíndice. Puede que esto se resuelva en el futuro.

  • Ticket: CREATE-1599

• En Nuevo Reddit, el superíndice sin paréntesis no se procesa correctamente cuando va antes de una palabra que va seguida de un corchete de cierre, un paréntesis de cierre o un énfasis de cierre.

  • Ticket: CREATE-2474

• Los paréntesis sin escapar en los enlaces deben estar balanceados.

  • Debates previos: 1
  • Ticket: CREATE-1662

• Las listas anidadas necesitan al menos dos espacios de sangría para las listas no ordenadas y tres para las listas ordenadas, mientras que en Reddit Antiguo sólo se necesitaba un espacio.

  • Debates previos: 1
  • Ticket: CREATE-1702

• La primera celda de encabezado de la tabla no puede estar vacía si no va precedida de una barra vertical (|); por ejemplo, lo siguiente no funciona:

  (esta línea es un truco para abrir un bloque de código en Reddit Antiguo y no forma parte del ejemplo)
  
   |B|C
  -|-|-
  d|e|f
  

  • Debates previos: 1
  • Ticket: CREATE-1701

• El primer elemento para marcar celdas en una tabla no puede ser una raya seguida de un espacio, a menos que vaya precedida de una barra vertical (|); si no la tiene, se la interpretará como el comienzo de una lista. Por ejemplo, el siguiente ejemplo no es correcto:

  (esta línea es un truco para abrir un bloque de código en Reddit Antiguo y no forma parte del ejemplo)
  
  A | B
  - | -
  c | d
  

  • Debates previos: 1
  • Ticket: CREATE-1708

• No es necesario que el texto spoiler esté "pegado"; es decir, los delimitadores del texto spoiler (>! y !<) se procesarán como como tales independientemente de si están junto a espacios en blanco y signos de puntuación.

  • Debates previos: 1
  • Ticket: CREATE-1534

• No se admiten citas en bloque marcadas como spoiler, es decir, citas en bloque escritas con >! en lugar de >.

  • Ticket: CREATE-1723

• La sintaxis de enlaces no permite que haya espacio entre los corchetes ([]) y los paréntesis (()).

  • Debates previos: 1 2
  • Ticket: CREATE-1438

• Más de dos virgulillas (~) en la sintaxis de texto tachado, por ejemplo, a ~~~b~~~ c—, se tratan de manera diferente: en Reddit Antiguo los extras no desaparecen, mientras que en Nuevo Reddit sí. Además, en Nuevo Reddit, más de dos virgulillas al principio de una línea pueden interpretarse como delimitadores de código.

• Las líneas que solo contienen signos de número (#) se manejan de forma diferente: en Reddit Antiguo, estas líneas se consumen por completo y no se muestran, mientras que en Nuevo Reddit, 6 signos de número o menos se muestran como un encabezado vacío. Cuando hay más de 6, se muestran como un párrafo compuesto por signos de número.

• Algunos casos extremos en torno al procesamiento de los enlaces que contienen espacios son diferentes, específicamente con respecto a su interacción con los títulos de los enlaces.

• Hay otros casos de diferencias en el procesamiento de los enlaces, algunos de los cuales se consideran errores y otros aún no están determinados.

  • Debates previos: 1
  • Ticket: CREATE-2206

• Algunos casos de procesamiento de negritas o cursivas “en el interior de la palabra” (es decir, strong + emph) son diferentes. Por ejemplo, en Reddit Antiguo, a**_b_**c se procesa como negrita y cursiva, mientras que en CommonMark, no.

  • Debates previos: 1

• Las listas ordenadas deben empezar con “1”. No se admiten otros números de inicio. En Reddit Antiguo, se procesaban otros números de inicio, aunque las listas siempre se mostraban como si empezaran desde el 1.

• En Nuevo Reddit, se permiten los énfasis anidados como _a __b c b__ d_ de forma consistente, mientras que en Reddit Antiguo estos casos suelen procesarse de forma incorrecta.

• Los enlaces dentro de otros enlaces se procesan de manera diferente: por ejemplo, [[a](http://example.com)](http://example.com).

• En Nuevo Reddit no se admite el texto spoiler dentro del texto de los enlaces.

  • Ticket: CREATE-2623

• Las listas no ordenadas delimitadas con + no funcionan en Nuevo Reddit. Esto es en contra de las especificaciones de CommonMark.

  • Ticket: CREATE-2403

• Los encabezados no pueden contener elementos arbitrarios  dentro de una línea  (como cursivas) en Nuevo Reddit. Esto es en contra de las especificaciones de CommonMark.

  • Ticket: CREATE-2668

• Del mismo modo, en Nuevo Reddit se admite el prefijo de una URL por sí solo como una URL válida, mientras que Reddit Antiguo requiere que el prefijo vaya seguido de otros caracteres.

• El contenido de un párrafo seguido de una línea que parece una lista no ordenada se interpreta como el cierre de un párrafo y la apertura de una lista no ordenada, mientras que Reddit Antiguo continuaba el párrafo.

• Las definiciones de los enlaces de referencia pueden aparecer dentro de las citas en bloque.

• Los tramos de código en línea que contienen acentos graves pueden estar compuestos por cualquier número de acentos graves en secuencia, mientras que en Reddit Antiguo los acentos graves más externos necesitan ser la cadena más larga de acentos graves en el texto del código. `` `code` `` funciona en ambas versiones, mientras que ` ``code`` ` solo es compatible con Nuevo Reddit.

• Los elementos de bloque anidados (como listas, citas en bloque y tablas) pueden abrirse en la misma línea que los elementos de una lista.

Diferencias respecto de CommonMark/GFM

• Las imágenes incrustadas no son compatibles con el modo Markdown, solo con el editor completo.

• La sintaxis de superíndice es como la de Reddit Antiguo, no comrak.

• Las listas ordenadas deben empezar con “1”. No se admiten otros números de inicio.

• Los enlaces pueden contener espacios.

• Las líneas que solo contienen signos de número (#) reciben un tratamiento diferente.

• En los encabezados, no se requieren espacios después de los signos de número.

• Los encabezados con más de 6 signos de número se procesan de forma distinta, como encabezados de nivel 6 con signos de número en el texto del encabezado (p. ej.: #######valhallaforolaf). En CommonMark, estas construcciones no se procesan como encabezados.

• Una fila de celdas en una tabla puede comenzar con un guión seguido de un espacio, mientras que en CommonMark eso abriría una nueva lista no ordenada:

  (esta línea es un truco para abrir un bloque de código de Reddit Antiguo y no forma parte del ejemplo)
  
  A | B | C
  --|---|--
  - | e | f
  

  (Ten en cuenta que esto no se aplica actualmente a la "fila de formato" que sigue a la fila del encabezado; por lo tanto, lo siguiente no se muestra como una tabla,

  (esta línea es un truco para abrir un bloque de código de Reddit Antiguo y no forma parte del ejemplo)
  
  
  A | B | C
  - | - | -
  - | e | f
  

  mientras que en Antiguo Reddit sí).

• Para el texto tachado, se quieren dos virgulillas (~~) en Reddit Antiguo, no una como en CommonMark.

• No se admiten los enlaces relativos.

• No se admite HTML dentro de una línea.

• Las listas no ordenadas delimitadas con + no funcionan en Nuevo Reddit.

• Los encabezados no pueden contener elementos dentro de una línea (como cursivas) en Nuevo Reddit.

Diferencias en compatibilidad de contenido entre Reddit Antiguo y Nuevo Reddit

En la sección Dónde usar Markdown en Reddit, se describen las funciones específicas de Reddit que admiten ingresar Markdown. Hasta ahora, hay diferencias significativas en el soporte de estos diversos casos entre Reddit Antiguo y Nuevo Reddit, y entre el antiguo procesador de Markdown y el nuevo.

Estos son los detalles importantes.

• Autotexto: si bien en Nuevo Reddit se usa el nuevo procesador y despliegue de Markdown para mostrar el autotexto en casi todas partes, incluyendo el enlace directo de los posts y en “lightbox” (la ventana emergente que aparece al hacer clic en un post en la vista de listas), también se usa el procesador  anterior de Markdown en las vistas previas de las listas, tanto en la vista de tarjeta predeterminada como en el “expandible” (los detalles que se muestran al hacer clic en el icono de dos flechas opuestas) de la vista clásica.

• Wikis:  por ahora, sólo se muestran por medio de Reddit Antiguo.

• Descripción de subreddits: no se interpreta como Markdown en Nuevo Reddit. Además, el contenido que antes era multilínea ahora se limita a una sola línea.

• Texto de envío a subreddits: no se muestra en Nuevo Reddit.

• Barra lateral de “área de texto” de Nuevo Reddit: se muestra usando Reddit Antiguo.

• Reglas de subreddits: siempre se muestran usando Reddit Antiguo.

• Texto “Acerca de” en los perfiles de usuario con el nuevo estilo: siempre se muestra usando Reddit Antiguo.

Diferencias entre el editor completo y Markdown

El editor completo WYSIWYG es generalmente compatible con la mayoría de las funciones de Markdown que admite Reddit, pero tiene algunas limitaciones. Por debajo de la mesa, el editor completo almacena sus documentos como Markdown, pero su interfaz no admite todas las funciones en Markdown de Reddit.

• No se pueden introducir entidades HTML en el editor completo.

• El editor completo tiene “límites de anidamiento” mucho más bajos que usando Markdown directamente. Los límites de anidamiento afectan la profundidad con la que se pueden crear listas anidadas y citas en bloque en el documento.

• Los elementos multimedia, como las imágenes y los videos, se pueden incrustar en el contenido a través del editor completo, pero no usando Markdown directamente.

• El editor completo sólo admite un único nivel de encabezado.

• El editor completo no admite colocar elementos de bloque arbitrarios como listas, citas en bloque y tablas dentro de listas o citas en bloque.

• El editor completo no admite definiciones de referencia de enlaces: los enlaces repetidos deben insertarse repetidamente.

• El editor completo no admite los saltos de línea sin inicio de párrafo.

• El editor completo puede crear líneas en blanco, mientras que Markdown no puede hacerlo. Lo hace con un truco compatible con versiones anteriores, insertando párrafos que contienen un solo espacio de ancho cero (​), que el procesador de Markdown convierte posteriormente en un párrafo vacío. Técnicamente, al escribir en Markdown se puede hacer el mismo truco.

Aunque la página de envío tiene la opción de cambiar entre los modos de editor completo y Markdown, hay que tener cuidado al cambiar de Markdown al editor completo . Aunque se espera que el cambio del editor completo a Markdown sea sin pérdidas, lo inverso no es cierto. Por ejemplo, si el Markdown contiene elementos de HTML, se convertirán a Unicode sin formato durante la conversión, se perderán las listas anidadas, etcétera. Adicionalmente, al  regresar  del editor completo a Markdown, el Markdown exacto que tenías se perderá y será remplazado por Markdown generado a partir del texto en el editor completo.

Créditos y lecturas adicionales

Un gran agradecimiento a /u/brson por crear este documento y trabajar tan diligentemente para mejorar nuestro procesador de Markdown. La organización básica de esta página y su contenido fueron influenciados por el manual básico de Markdown para Reddit de /u/AnteChrono, la Guía de formato de comentarios de Redditde /u/Raerth, la página de la wiki de "comentarios" actual y la página de ayuda de CommonMark.

Citas y referencias usadas como ejemplos:

• “Lejos en los remansos inexplorados...”, Douglas Adams
• "Más allá de las ideas de maldad...", "El amor lo es todo...", "No te preocupes por nada...", Rumi
• “Muy poco hace falta para tener una vida feliz...” , Marco Aurelio
• “En algún lugar de la Mancha...”, Miguel de Cervantes
• "Es sólo el error...", Thomas Paine
• “Lo mejor que aprenderás...”, eden ahbez
• “Agamenón, …” — Esquilo
• “Es tan difícil olvidar el dolor...”, Chuck Palahniuk
• “Sentí que los pulmones se me inflaban...”, Sylvia Plath