Skip to main content

Ayuda de Markdown

contraer | en la sección anterior aparece entre comillas para facilitar la lectura de la ayuda de edición completa, a continuación.

Aplica una sangría de cuatro espacios para crear un bloque <pre> <code> con escape:

    printf("%d\n", 42);  /* ¿cuál era
                            la pregunta? */

También puedes seleccionar texto y pulsar CTRL+K para alternar la indentación como código.

El texto irá dentro de esas etiquetas, y presentado en una fuente monoespaciada. Los primeros cuatro espacios se eliminan, pero cualquier otro espacio en blanco será preservado.

En un bloque de código, Markdown y HTML se ignoran:

    <blink>
       No te gustaría esto si no estuviera
     encapsulado en un bloque de código.
    </blink>

En lugar de utilizar la indentación, también puedes crear bloques de código utilizando "cercas de código", que consisten en tres o más acentos graves o virgulillas:

```
alert(false);
```

~~~
alert(true);
~~~

Utiliza acentos graves para crear un intervalo <code> insertado:

El carácter `$` es un acceso directo para `window.jQuery`.

(La tecla de acento grave se encuentra generalmente próxima al Enter o en la esquina superior izquierda del teclado).

Al igual que los bloques de código, los intervalos de código se mostrarán con una fuente monoespaciada. Markdown y HTML no funcionarán dentro de ellos. Ten en cuenta que, a diferencia de los bloques de código, los intervalos de código requieren que escapes manualmente cualquier HTML dentro de ellos.

Si el código contiene acentos graves, es posible que debas utilizar varios acentos graves como delimitadores:

El nombre ``Tuple`2`` es un nombre de tipo .NET válido.

Coloca dos espacios al final de la línea para añadir un salto de línea <br/>:

¿Cómo es que te amo?  
Permíteme decirlo
*Esto está en cursiva*, y _esto_ también.
**Esto está en negrita**, y __esto__ también.
Utiliza ***cursiva y negrita juntas*** si lo ___necesitas___.

También puedes seleccionar texto y pulsar CTRL+I o CTRL+B para alternar los formatos de cursiva o negrita respectivamente.

Existen tres maneras de escribir enlaces. Cada una es más fácil de leer que la anterior:

Este es un enlace insertado a [Google](https://www.google.com/).
Este es un enlace de estilo de referencia a [Google][1].
Este es un enlace de muy fácil lectura a [Yahoo!][yahoo].

  [1]: https://www.google.com/
  [yahoo]: https://www.yahoo.com/

También puedes seleccionar texto y pulsar CTRL+L para convertirlo en un enlace, o pulsar CTRL+L sin ningún texto seleccionado para insertar un enlace en la posición actual.

Las definiciones de enlace pueden aparecer en cualquier parte del documento: delante o detrás del lugar en que los utilizas. Los nombres de definición de enlace [1] y [yahoo] pueden ser una única cadena y no distinguen mayúsculas de minúsculas; [yahoo] es lo mismo que [YAHOO].

Los enlaces pueden tener un atributo de título, que se muestra al mantener el puntero del mouse sobre ellos. También se pueden añadir atributos de título. Estos son útiles si el enlace en sí no es lo suficientemente descriptivo como para que los usuarios sepan adónde se los dirige.

Here's a <span class="bg-black-300">[poorly-named link](https://www.google.com/ "Google")</span>.
Nunca escribas "[hacer clic aquí][^2]".
[Visítanos][web].
  [^2]: https://www.w3.org/QA/Tips/noClickHere
        (No se recomienda la frase “hacer clic aquí”)
  [web]: https://es.stackoverflow.com/ "Stack Overflow en español"

Además, puedes utilizar la sintaxis de hipervínculo HTML estándar.

<a href="https://example.com" title="ejemplo">ejemplo</a>

Modificamos nuestro analizador de Markdown para admitir las URLs “al descubierto” (en la mayoría, pero no en todos los casos –ten cuidado con los caracteres especiales en las URLs). Se convierten en enlaces automáticamente:

A menudo visito https://example.com.

Fuerza las URL encerrándolas entre corchetes angulares:

¿Has visto <https://example.com>?

Las URL pueden ser relativas o completas.

Subraya el texto para crear los dos encabezados <h1> <h2> de máximo nivel:

Encabezado 1
========
Encabezado 2
--------

También puedes seleccionar texto y pulsar CTRL+H para alternar entre los diferentes estilos de encabezado.

La cantidad de signos = o - no importa. Con uno basta. Pero si utilizas los suficientes para subrayar el texto, logras que los títulos se vean mejor en texto sin formato.

Utiliza almohadillas para varios niveles de encabezados:

# Encabezado 1 #
## Encabezado 2 ##
### Encabezado 3 ###

Los caracteres de cierre # son optativos.

Inserta una regla horizontal <hr/> mediante la colocación de tres o más guiones, asteriscos o guiones bajos solos en una línea:

---

También puedes pulsar CTRL+R para insertar una línea horizontal.

Regla n.° 1
---
Regla n.° 2
*******
Regla n.° 3
___

Utilizar espacios entre los caracteres también sirve:

Regla n.° 4
- - - -

También puedes pulsar CTRL+R para insertar una línea horizontal.

Una lista con viñetas <ul>:

- Utiliza un signo menos para las viñetas
+ O un signo más
* O un asterisco

Una lista <ol> numerada:

1. Las listas numeradas son sencillas
2. Markdown se encarga de llevar la cuenta de los números
7. Por lo tanto, este es el elemento 3.

También puedes seleccionar texto y pulsar CTRL+U o CTRL+O para alternar los formatos de lista de viñetas o lista numerada respectivamente.

Lista a doble espacio:

- Esta lista se encapsula entre etiquetas <p>.
 
- Por lo tanto, habrá espacio de sobra entre los elementos

Para colocar otros bloques de Markdown en una lista, simplemente aplica una sangría de cuatro espacios para cada nivel de anidamiento:

1. Listas en un elemento de lista:
    - Sangría de cuatro espacios.
        * sangría de ocho espacios.
    - Cuatro espacios otra vez.
1. Listas en un elemento de lista:
    - Sangría de cuatro espacios.
        * sangría de ocho espacios.
    - Cuatro espacios otra vez.
2.  Varios párrafos en elementos de lista:
    Se recomienda aplicar sangría de cuatro espacios a los párrafos.
    Puedes utilizar tres, pero puede ser
    confuso cuando anidas otras cosas.
    Sigue con cuatro.
 
    Aplicamos una sangría con un espacio adicional en la primera línea para alinear
    con estos párrafos.  En la práctica, es posible que hagamos
    esto a la lista completa para que todos los elementos se alineen.
 
    Este párrafo aún es parte del elemento de lista, pero para las personas se ve desordenado.  Por eso, es una buena idea encapsular los párrafos anidados manualmente, como hicimos con los primeros dos.
 
3. Citas en bloque en un elemento de lista:
 
    > Omite una línea y
    > aplica una sangría de cuatro espacios delante de >.
 
4. Texto con formato previo en un elemento de lista:
 
        Omite una línea y aplica una sangría de ocho espacios.
        Son cuatro espacios para la lista
        y cuatro para desencadenar el bloque de código.

Añade > delante de cualquier línea para crear una cita en bloque.

> La sintaxis se basa en la manera en que los programas de correo electrónico
> suelen hacer las citas. No necesitas realizar ajustes manuales a
> los párrafos de tus citas en bloque, pero luce mucho mejor si lo haces.  Depende de tu ánimo para hacerlo.

También puedes seleccionar texto y pulsar CTRL+Q para alternar el formato de cita.

Para insertar otros bloques Markdown en una cita en bloque, añade un > seguido de un espacio:

Para insertar otros bloques Markdown en una cita en bloque, añade un > seguido de un espacio:

> El `>` en las líneas en blanco es necesario
> para crear una sola cita en bloque.
> 
> Si suprimes el `>` extra
> terminarás con
> dos citas en bloque distintas.

Citas en bloque dentro de una cita en bloque:

> Una cita en bloque estándar tiene un nivel de sangría
> > Una cita en bloque anidada tiene más sangría
> > > > Puedes anidar hasta cualquier nivel de profundidad.

Listas en una cita en bloque:

> - Una lista en una cita en bloque
> - Con un &gt; y un espacio a continuación
>    * Una sublista

Texto con formato previo en una cita en bloque:

>     Marca sangría con cinco espacios en total. El primero
>     es parte del indicador de cita en bloque.

Las imágenes son exactamente iguales a los enlaces, pero tienen un signo de exclamación delante:

![XHTML válido](https://w3.org/Icons/valid-xhtml10).

También puedes pulsar CTRL+G para insertar una imagen.

La palabra entre corchetes es el texto alternativo, que se muestra si el navegador no puede mostrar la imagen. Asegúrate de incluir un texto alternativo con sentido para el software de lectura en pantalla.

Al igual que los enlaces, las imágenes funcionan con sintaxis y títulos de referencia:

Esta página es ![XHTML válido][checkmark].

[marca de verificación]: https://w3.org/Icons/valid-xhtml10
             “¿Por qué sonríes?”

Nota: Actualmente, Markdown no admite la sintaxis de referencia más corta para las imágenes:

Esta es una ![marca de verificación] rota.

Puedes utilizar una versión un poco más extensa de los nombres de referencia implícitos:

Esta ![marca de verificación][] sirve.

El nombre de referencia también se usa como texto alternativo.

Además, puedes utilizar la sintaxis de imagen HTML estándar, que te permite escalar el ancho y la altura de la imagen.

<img src="https://example.com/sample.png" width="100" height="100">

Las URL pueden ser relativas o completas.

Si necesitas hacer algo que Markdown no puede manejar, utiliza HTML. Ten en cuenta que solo soportamos un subconjunto muy estricto de HTML.

 Para reiniciar tu computadora, presiona <kbd>ctrl </kbd>+ <kbd>alt </kbd>+ <kbd>supr</kbd>.

Markdown es lo suficientemente inteligente como para no arruinar el HTML de nivel de intervalo:

<b>El Markdown funciona *correctamente* aquí.</b>

Los elementos de bloque HTML tienen algunas restricciones:

  1. Se deben separar del texto que las rodea con líneas en blanco.
  2. No se debe aplicar sangría a las etiquetas iniciales y finales del bloque más alejado.
  3. No se puede utilizar Markdown en bloques HTML.
<pre>
    <em>No</em> puedes utilizar Markdown aquí.
</pre>

¿Necesitas más detalles?

Visita la especificación oficial de CommonMark (en inglés).


Adiciones a Stack Exchange

Las siguientes secciones describen algunas características adicionales para el formato de texto que no son parte oficialmente de CommonMark.

Para hablar acerca de una etiqueta en este sitio, , utiliza

Consulta las diversas preguntas con la etiqueta [tag:elefantes] para obtener más información.

La etiqueta se vinculará automáticamente a la página de etiqueta correspondiente.

Para ocultar un determinado fragmento de texto y hacerlo visible solo cuando el usuario haga clic en él, usa la sintaxis de cita en bloque con un signo de exclamación adicional:

Al final del quinto episodio se revela que
>! él es en realidad su padre.

Los bloques de código serán resaltados usando highlight.js. En muchos casos, el lenguaje de resaltado de sintaxis se inferirá de las etiquetas de la pregunta.

Para especificar manualmente el lenguaje de un bloque de código cercado, añade el lenguaje a la línea con la cerca de apertura:

``` lang-js
setTimeout(function () { alert("JavaScript"); }, 1000);
```

Puedes utilizar uno de los códigos de lenguaje soportados como lang-cpp or lang-sql, o puedes especificar una etiqueta, y se utilizará el lenguaje de resaltado de sintaxis asociado a esta etiqueta.

Para especificar el lenguaje de resaltado de sintaxis que se debe usar no solo para el siguiente bloque de código, sino para todos los posteriores, utiliza esta etiqueta:

<!-- language-all: lang-html -->

Para especificar que no quieres resaltado de sintaxis en un bloque de código, utiliza lo siguiente:

<!-- language: lang-none -->

Our support for tables is based on the GitHub-flavored markdown table extension specification.

| Una cabecera | Otra cabecera |
| ------------ | ------------- |
| Primera      | fila          |
| Segunda      | fila          |

Alineación

Puedes establecer la alineación de una columna de la tabla incluyendo un : en la celda correspondiente de la línea de separación. Un : a la izquierda hará que la columna esté alineada a la izquierda (es el valor predeterminado). Un : a la derecha la alineará a la derecha. Colocando : a la izquierda y a la derecha se producirá una columna alineada al centro.

| izquierda | centro | derecha |
|:--------- |:------:| -------:|
| Uno       | Dos    | Tres    |

Detalles de sintaxis

  • Se requiere una fila de cabecera y debe ir seguida de una fila de separación con el mismo número de celdas
  • Las celdas se separan con una barra vertical (|)
  • Las barras verticales al inicio y final son opcionales
  • No es necesario que el espaciado y los caracteres - estén alineados visualmente

Los comentarios solo admiten negrita, cursiva, código y enlaces; además, hay algunos enlaces abreviados disponibles.

texto en _cursiva_ y **negrita**,
`código en acentos graves` insertado
y [enlaces básicos](https://example.com).

Enlaces abreviados admitidos:

  • [meta] – enlace al sitio Meta actual; el texto del enlace es el nombre del sitio (p. ej., “Súper usuario Meta”). No sucede nada si el sitio no tiene (o ya es) un sitio Meta.

  • [main] – como [meta], pero al revés.

  • [edit] – enlace a la página de edición de la publicación donde se encuentra el comentario; es decir, /posts/{id}/edit. El texto del enlace es “edit” (se respeta el uso de mayúsculas).

  • [tag:tagname] y [meta-tag:tagname]: enlace a la página de la etiqueta determinada. El texto del enlace es el nombre de la etiqueta.meta-tag solo funciona en los sitios meta.

  • [help], [help/on-topic], [help/dont-ask], [help/behavior] y [meta-help]: enlace a las páginas del centro de ayuda que se visitan con frecuencia. El texto del enlace es “centro de ayuda” (se respeta el uso de mayúsculas). Todos los enlaces conducen al sitio principal.

  • [tour] – vínculo a la página del recorrida. El texto del vínculo es “recorrido” (se respeta el uso de mayúsculas).

  • [so], [pt.so], [su], [sf], [metase], [a51], [se] – enlace al sitio determinado. El texto del enlace es el nombre del sitio.

  • [chat] – enlace a la sala de chat del sitio actual; el texto del enlace es “Chat de {site name}”.

  • [ask], [what you are asking], [answer] – enlace a la página Cómo preguntar o Cómo responder.

  • [code block] – enlace a la página de ayuda de markdown. El texto del enlace es "code block".

  • [mcve], [mre], [reprex], [repro], [example] – enlace a /help/minimal-reproducible-example, con el texto de enlace "ejemplo mínimo verificable".

  • [algo.se]: enlace a algo.stackexchange.com, si el sitio existe. El texto del enlace es el nombre del sitio. Utiliza [ubuntu.se] para Ask Ubuntu.

El propietario de la publicación en la que estás comentando siempre recibirá notificaciones sobre tu comentario. Si le estás respondiendo a otra persona que ya comentó en la misma publicación, menciona el nombre de usuario: @peter y @PeterSmith notifican a una persona que ya comentó llamada “Peter Smith”.

Por lo general, basta con mencionar solo el nombre del usuario a cuyo comentario estas respondiendo, p. ej., @ben o @marc. Sin embargo, es posible que debas ser más específico si hay tres personas con el nombre Ben que comentaron anteriormente. Añade el primer carácter del apellido, p. ej.: @benm o @benc\. Los espacios no son válidos en los nombres de las respuestas a los comentarios; así que, no utilices @peter smith, siempre introdúcelo como @peters o @petersmith.

Si el usuario al que le respondes no tiene un nombre y apellido normal, simplemente introduce la suficiente cantidad de caracteres del nombre para aclarar a quién le respondes. El mínimo es de tres caracteres, por lo que si le respondes a “Fantástico”, introduce @fan, @fant o @fantástico.

Puedes utilizar el mismo método para notificar a cualquier editor de la publicación o, si este fuera el caso, al moderador que cerró la pregunta.