Tutorial rápido y letal de Markdown

Markdown es un lenguaje de marcado ligero creado por John Gruber que trata de conseguir la máxima legibilidad y facilidad de publicación tanto en su forma de entrada como de salida, inspirándose en muchas convenciones existentes para marcar mensajes de correo electrónico usando texto plano.
¿Por qué Markdown?

Markdown tiene el objetivo de ayudarte a concentrar en la escritura en vez de en el formateo del documento. Markdown usa caracteres de puntuación comunes. Por ejemplo: si rodeas con asteriscos una esta se verá como palabra en itálica y en HTML como palabra en itálica. ¿Dos asteriscos? **Palabra en negritas** se transforma en Palabra en negritas. Incluso, muchas implementaciones de Markdown nos permiten escribir en LaTeX colocando el texto entre $, $\int_{a}^{b} x^2 dx$ produce \int_{a}^{b} x^2 dx. Markdown tiene estilos de sintaxis para títulos, listas, citas o block quotes, enlaces y más (ver abajo).

¿Para qué nos sirve?

Ayuda a reporteros a escribir velozmente y facilita la colaboración. Muchas salas de redacción y periodistas usan Markdown para escribir sus contenidos, especialmente si pasan por un proceso de edición y de producción digital colectiva que incluye a otros reporteros, diseñadores y programadores. Incluso, este blog está escrito en Markdown.

Yo uso Markdown para:

  • Notebooks de Jupyter.
  • Escribir este blog.
  • Tomar notas y hacer formularios (cheatsheet).
  • En Github.

Editores de Markdown

Remarkable

Remarkable.png

Con este editor puedes escribir Markdown y ver los cambios a medida que los hace en la ventana de live preview. Puedes exportar sus archivos a PDF (con un índice) y HTML. Incluso hay varios estilos disponibles junto con amplias opciones de configuración.

Otras características incluyen:

  • Resaltado de sintaxis.
  • Soporte de GitHub Flavoured Markdown
  • Compatibilidad con MathJax
  • Atajos de teclado

Atom

Screenshot_20171201_103923.png

Atom es un fabuloso editor de texto. De lejos, Atom es mi editor de código favorito. Pero como editor de Markdown, Atom deja mucho que desear: sus paquetes predeterminados carecen de características específicas de Markdown; por ejemplo, no representa ecuaciones de \LaTeX.

Pero Atom es un editor totalmente extensible a través de paquetes. El paquete Markdown Preview Plus proporciona un live preview de los documentos y con representación matemática. Tambien podemos tener el desplazamiento automático con el paquete markdown-scroll-sync. Otros paquetes muy útiles son Markdown-Writer y markdown-pdf.

StackEdit

StackEdit

StackEdit es un editor de Markdown completo basado en PageDown, la biblioteca de Markdown utilizada por Stack Overflow y los otros sitios de Stack Exchange. A diferencia de otros editores en este resumen, StackEdit es un editor basado en la web.

Las características incluyen:

  • Vista previa en tiempo real con desplazamiento.
  • Compatibilidad Markdown Extra, GitHub Flavoured Markdown y Prettify / Highlight.js.
  • Expresiones matemáticas \LaTeX usando MathJax.
  • Botones de control WYSIWYG.
  • Diseño configurable.
  • Diferentes temas disponibles Sincronización en línea con Google Drive (cuentas múltiples) y Dropbox.
  • Publicación en Blogger, Dropbox, Gist, GitHub, Google Drive, servidor SSH, Tumblr y WordPress.

Escribiendo en Markdown

Encabezados o títulos

Para colocar un título usamos #:

# Título 1
## Título 2
### Títilo 3
#### Título 4

Se transforma en:


Título 1

Título 2

Títilo 3

Título 4


Texto en cursiva y negrita

Texto en cursiva: *cursiva*, negrita: **negrita** o cursiva negrita: ***cursiva negrita***.

Listas

Sin numerar

* Un elemento sin numerar
    - Sub elemento
        - Sub sub elemento
    - Sub elemento
        - Una cosa
        - Otra cosa
* Segundo elemento sin numerar
    - Sub elemento
* Tercero
    - Sub elemento
  • Un elemento sin numerar
    • Sub elemento
      • Sub sub elemento
    • Sub elemento
      • Una cosa
      • Otra cosa
  • Segundo elemento sin numerar
    • Sub elemento
  • Tercero
    • Sub elemento

Numerada:

1.  Punto uno
    1.  Sub punto uno
    2.  Sub punto dos
1.  Punto dos (no importa el número)
3.  Punto tres
  1. Punto uno
    1. Sub punto uno
    2. Sub punto dos
  2. Punto dos (no importa el número)
  3. Punto tres

Línea horizontal

Se puede hacer una línea horizontal con:

---

o con

***

también

___

y se mostraría


Blockquote

Para colocar un bloque de cita usamos >

>Hermoso es mejor que feo.
>Explícito es mejor que implícito.
>Simple es mejor que complejo.
>Complejo es mejor que complicado.
>Sencillo es mejor que anidado.
>Escaso es mejor que denso.
>La legibilidad cuenta.
>Los casos especiales no son lo suficientemente especiales para romper las reglas.
>Lo práctico le gana a la pureza.
>Los errores no debe pasar en silencio.
>A menos que sean silenciados.
>En cara a la ambigüedad, rechazar la tentación de adivinar.
>Debe haber una – y preferiblemente sólo una – manera obvia de hacerlo.
>Aunque esa manera puede no ser obvia en un primer momento a menos que seas holandés.
>Ahora es mejor que nunca.
>Aunque “nunca” es a menudo mejor que “ahora mismo”.
>Si la aplicación es difícil de explicar, es una mala idea.
>Si la aplicación es fácil de explicar, puede ser una buena idea.
>Los espacios de nombres son una gran idea ¡hay que hacer más de eso!
>>El Zen de Python

Hermoso es mejor que feo.
Explícito es mejor que implícito.
Simple es mejor que complejo.
Complejo es mejor que complicado.
Sencillo es mejor que anidado.
Escaso es mejor que denso.
La legibilidad cuenta.
Los casos especiales no son lo suficientemente especiales para romper las reglas.
Lo práctico le gana a la pureza.
Los errores no debe pasar en silencio.
A menos que sean silenciados.
En cara a la ambigüedad, rechazar la tentación de adivinar.
Debe haber una – y preferiblemente sólo una – manera obvia de hacerlo.
Aunque esa manera puede no ser obvia en un primer momento a menos que seas holandés.
Ahora es mejor que nunca.
Aunque “nunca” es a menudo mejor que “ahora mismo”.
Si la aplicación es difícil de explicar, es una mala idea.
Si la aplicación es fácil de explicar, puede ser una buena idea.
Los espacios de nombres son una gran idea ¡hay que hacer más de eso!

El Zen de Python

Enlaces

[Enlace a Google](https://www.google.com)
[Enlace a Google con título](https://www.google.com "Buscardor Google")

Enlace a Google

Enlace a Google con título

Código

Puedes escribir código dejando 4 espacios:

def f(x):
    """Calcula el cuadrado de un número"""
    return x**2

O con resaltado de sintaxis usando

produce

def f(x):
        """Calcula el cuadrado de un número"""
        return x**2

Tablas

|  Esta  |  es  |
|--------|------|
|   una  | tabla|
|$\theta$|$x^2$ |
Esta es
una tabla
\theta x^2

Sin importar que no esté alineada

Las | tablas | no alineadas
--- | --- | ---
*se siguen* | `viendo` | **bien**
1 | 2 | 3
Las tablas no alineadas
se siguen viendo bien
1 2 3

HTML

también podemos escribir en HTML

<table>
<tr>
<th>Header 1</th>
<th>Header 2</th>
</tr>
<tr>
<td>row 1, col 1</td>
<td>row 1, col 2</td>
</tr>
<tr>
<td>row 2, col 1</td>
<td>row 2, col 2</td>
</tr>
</table>
Header 1 Header 2
row 1, col 1 row 1, col 2
row 2, col 1 row 2, col 2

Imágenes

![](https://cdn.foliovision.com/images/2017/03/i-love-markdown-580x387.png "Markdown")

Bueno, esto es todo por hoy. espero que esta información sea de utilidad. Cualquier duda o sugerencia dejame tu comentario

Advertisements

One thought on “Tutorial rápido y letal de Markdown

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s