3

Guía practica para darle estilo a tus comentarios y tutoriales dentro de Platzi.

<h1>¿Qué es Markdown?</h1>

Markdown es una herramienta de conversión de texto a HTML para escritores web. Markdown le permite escribir utilizando un formato de texto sin formato fácil de leer y escribir, y luego convertirlo en XHTML (o HTML) estructuralmente válido.

Por lo tanto, “Markdown” es dos cosas:

  1. una sintaxis de formato de texto sin formato; y
  2. una herramienta de software, escrita en Perl, que convierte el formato de texto sin formato a HTML.

Tomado de Git-hub

Nota:

Ojala esta publicación te resulte de utilidad, sin embargo no puedo garantizar que todo funcione correctamente pues este será mi primer tutorial publicado en Platzi. Personalmente prefiero usar Mozila Firefox pero he podido notar que el editor no funciona bien con algunas etiquetas en ese navegador como por ejemplo la de los encabezados y la de Youtube, por ende he realizado esta publicación en Google Chrome donde al parecer si funcionan bien (solo lo sabré al enviar esta publicación). Si sabes de alguna etiqueta que se me haya escapado por favor añádela en los comentarios. Gracias.

<h1>Guía de uso</h1>

Encabezados

## Esta es una etiqueta <h2>### Esta es una etiqueta <h3>#### Esta es una etiqueta <h4>##### Esta es una etiqueta <h5>###### Esta es una etiqueta <h6>

Produce:

<h1>Esta es una etiqueta <h1></h1>

Esta es una etiqueta <h2>

<h3>Esta es una etiqueta <h3></h3> <h4>Esta es una etiqueta <h4></h4> <h5>Esta es una etiqueta <h5></h5> <h6>Esta es una etiqueta <h6></h6>

Énfasis

*Este texto aparecerá en cursiva*
_Este texto también aparecerá en cursiva_
**Este texto aparecerá en negrilla**
__Este texto también aparecerá en negrilla__
~~Este texto aparecerá tachado~~
_También **puedes** combinarlos_

Producirá
Este texto aparecerá en cursiva
Este texto también aparecerá en cursiva
Este texto aparecerá en negrilla
Este texto también aparecerá en negrilla
Este texto aparecerá tachado
También puedes combinarlos

Listas Ordenadas

1. Ítem 1
1. Ítem 2
1. Ítem 3
   1. Ítem 3a
   1. Ítem 3b

Producirá

  1. Ítem 1
  2. Ítem 2
  3. Ítem 3
    1. Ítem 3a
    2. Ítem 3b

Listas No ordenadas

* Ítem 1
* Ítem 2
  * Ítem 2a
  * Ítem 2b

Producirá

  • Ítem 1
  • Ítem 2
    • Ítem 2a
    • Ítem 2b

Imágenes

![Platzi logo]( https://static.platzi.com/static/css/logo.a76b2a87162b3b46529c30d1cb91ccc6.png)

Producira
Platzi logo
El formato sigue la siguiente regla: Texto alternativo para la imagen entre corchetes cuadrados precedido por el símbolo de cierre de exclamación, seguido por la url donde se encuentra almacenada la imagen dentro de paréntesis.

Enlaces

http://github.com – enlace creado de forma automática!
[Platzi](http://platzi.com)

Producirá
http://github.com – enlace creado de forma automática!
Platzi
El formato sigue la siguiente regla: El texto alternativo para el enlace entre corchetes cuadrados seguido de la url dentro de paréntesis. Si deseas que el texto mostrado sea igual al de la url solo debes escribir la url y será convertida automáticamente.

Citas

Como el famoso filosofo moderno Daddy Yanky dijo:
> Lo que paso> Paso.

Producirá
Como el famoso filosofo moderno Daddy Yanky dijo:

Lo que paso
Paso.

Resaltado de sintaxis para código

\````javascript
functionfancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
\````

Producirá

functionfancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

Listas de tareas

- [x] Tarea  realizada
- [x] Otra tarea realizada sin ordenar
- [ ] Tarea sin realizar

Producirá

  • [x] Tarea realizada
  • [x] Otra tarea realizada sin ordenar
  • [ ] Tarea sin realizar

Tablas

Primer Encabezado | Segundo Encabezado
------------ | -------------
Contenido dela columna 1 fila 1 | Contenido dela columna 2 fila 1
Contenido dela columna 1 fila 2 | Contenido dela columna 2 fila 2
Contenido dela columna 1 fila 3 | Contenido dela columna 2 fila 3

Producirá

Primer EncabezadoSegundo Encabezado
Contenido de la columna 1 fila 1Contenido de la columna 2 fila 1
Contenido de la columna 1 fila 2Contenido de la columna 2 fila 2
Contenido de la columna 1 fila 3Contenido de la columna 2 fila 3

Emojis

:kissing::laughing:

Producirá
😗
😆

Aquí puedes ver un listado completo de emojis (no todos están soportados)

Como escapar caracteres

si necesitas escapar caracteres puedes hacerlo usando la barra invertida \
por ejemplo

- [ ] \(Si vas a incluir paréntesis después de corchetes cuadrados) será necesario escapar el primer paréntesis

Producirá

  • [ ] (Si vas a incluir paréntesis después de corchetes cuadrados) será necesario escapar el primer paréntesis

BONUS: incrustar vídeos de Youtube

'@[youtube]( m_lEJyoWafo|https://www.youtube.com/watch?v=m_lEJyoWafo)'

Producirá

Donde el formato es el siguiente @ [youtube] (id del video | url del video).

No aseguro que esto última regla de etiquetado funcione y debo añadir que incrustar un video pone lento el editor pues trata de renderizarlo en cada modificación, por ello sugiero que si vas a incrustar un video sea lo último que añadas al redactar tu comentario o tutorial.

Escribe tu comentario
+ 2
2
15988Puntos

Como se puede ver, solo funciona la etiqueta de encabezados <h2>, las correspondientes a <h1> <h3> <h4> <h5> y <h6> no son interpretadas de igual manera. Me gustaría editar la publicación pero no es posible y considero que reenviarla seria tomado como spam así que la dejare como esta.