La Guía de Markdown es una guía de referencia gratuita que explica cómo usar Markdown, el lenguaje de marcado simple y más fácil de usar para formatear prácticamente cualquier tipo de documentos.

A continuación. Vamos a conocer un poco de la historia de Markdown, qué es Markdown, para qué sirve Markdown y cómo funciona Markdown.

Además, vamos a conocer todos los elementos utilizables con Markdown y los mejores editores para utilizar Markdown.

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero que puede usar para agregar elementos de formato a documentos de texto sin formato. Creado por John Gruber en 2004, Markdown es ahora uno de los lenguajes de marcado más populares del mundo.

Usar Markdown es diferente a usar un editor WYSIWYG . En una aplicación como Microsoft Word, hace clic en botones para formatear palabras y frases, y los cambios son visibles de inmediato. Markdown no es así. Cuando crea un archivo con formato Markdown, agrega sintaxis de Markdown al texto para indicar qué palabras y frases deben verse diferentes.

Es posible que te hayas encontrado con Markdown sin darte cuenta; en sitios como el chat de Facebook, Skype o Reddit te permiten usar diferentes tipos de Markdown para formatear tus mensajes.

Por ejemplo, para indicar un encabezado, agregas el mismo número de almohadillas que el encabezado que deseas crear (por ejemplo, una # Encabezado Uno). O para poner una frase en negrita, simplemente debes agregar dos asteriscos antes y después (por ejemplo, este texto está en negrita) del texto que deseas remarcar.

Es posible que te lleve un tiempo acostumbrarte a ver la sintaxis de Markdown a la misma vez que ves el texto que escribes, especialmente si estás acostumbrado a las aplicaciones WYSIWYG o a un software de escritura de documentos, como Office o similar.

En definitiva, Markdown es una excelente fórmula de escribir texto sin formato para la web.

Puede agregar elementos de formato de Markdown a un archivo de texto sin formato utilizando una aplicación de edición de texto. O puedes usar una de las muchas aplicaciones y editores de Markdown que existen para todos los sistemas operativos que existen: Windows, macOS, Linux, Android e iOS.

Además, existen numerosas aplicaciones basadas en web diseñadas específicamente para escribir en Markdown y no solamente eso; y además, cada vez más, tanto las páginas web como los software específicos para el escritorio, implementan la posibilidad de utilizar Markdown como formato de escritura práctica y rápida.

Según la aplicación que utilices, a veces, es posible que no puedas obtener una vista previa del documento formateado a tiempo real; pero eso está bien. Según Gruber, el creador del lenguaje de Markdown: “La sintaxis de Markdown está diseñada para ser discreta y legible, por lo que el texto de los archivos de Markdown se pueden leer incluso sin la necesidad de que sean procesados”.

El objetivo de diseño primordial de la sintaxis de formato de Markdown es hacerlo lo más legible posible. La idea es que un documento con formato Markdown se pueda publicar tal cual, como texto sin formato, sin que parezca que ha sido marcado con etiquetas o instrucciones de formato.

¿Por qué utilizar Markdown?

Quizás te preguntes por qué la gente usa Markdown en lugar de un editor WYSIWYG. ¿Por qué escribir con Markdown cuando puedes presionar botones en una interfaz para formatear tu texto? Resulta que hay un par de razones diferentes por las que la gente usa Markdown en lugar de los editores WYSIWYG.

  • Markdown se puede utilizar para todo. La gente lo usa para crear sitios web , documentos , notas , libros , presentaciones , mensajes de correo electrónico y documentación técnica.
  • Markdown es transportable. Los archivos que contienen texto con formato Markdown se pueden abrir utilizando prácticamente cualquier aplicación. Si decides que no te gusta la aplicación de Markdown que estás utilizando actualmente, puedes importar los archivos de Markdown a otra aplicación Markdown, al contrario de lo que hacen otros procesadores de texto, como por ejemplo Microsoft Word, que bloquean tu contenido en un formato de archivo propietario.
  • Markdown es independiente de la plataforma. Puede crear textos con formato Markdown en cualquier dispositivo y con cualquier sistema operativo.
  • Markdown está preparado para el futuro. Incluso si la aplicación que estás usando deja de funcionar en algún momento en el futuro, aún podrás leer tu texto con formato Markdown usando una aplicación de edición de textos, normal y corriente. Esta es algo a considerar, sobre todo cuando hablamos de libros, tesis universitarias u otros documentos importantes que deben perdurar indefinidamente.
  • Markdown está en todas partes. Los sitios web como Reddit y GitHub son compatibles con Markdown, y muchas aplicaciones de escritorio y basadas en la web lo admiten.

Prácticando con Markdown

La mejor manera de comenzar con Markdown es usarlo. Eso es más fácil que nunca, gracias a todas las herramientas gratuitas que lo han adaptado.

Ni siquiera necesitas descargar nada, si es que no lo deseas. Existen varios editores de Markdown en línea que puedes utilizar para comenzar a practicar a escribir con Markdown.

Por ejemplo, con Dillinger, que es uno de los mejores editores de Markdown en línea. Simplemente abre el sitio web de Dillinger y comienza a escribir en el panel izquierdo; en todo momento, estarás viendo el resultado final, a la derecho del documento.

Probablemente desearás mantener abierto el sitio web de Dillinger mientras lees la guía. De esta forma, puedes probar la sintaxis a medida que aprende sobre ella.

Una vez que t hayas familiarizado con Markdown, es posible que desees utilizar una aplicación de Markdown específica, que se puede instalar en tu computadora de escritorio o dispositivo móvil.

¿Cómo funciona Markdown?

Vale Pablo, todo lo anterior está muy bien. Pero, ¿Cómo funciona Markdown?

El editor de Dillinger, te facilita la escritura en Markdown porque oculta las cosas que suceden por detrás, pero vale la pena explorar el funcionamiento del proceso en sí.

Cuando escribes en Markdown, el texto se almacena en un archivo de texto sin formato que tiene una extensión .md o .markdown. ¿Pero luego que ocurre?

¿Cómo se convierte ese archivo con formato Markdown a HTML o a un documento listo para imprimir?

La respuesta corta, es que necesitas una aplicación capaz de procesar la escritura en el lenguaje de Markdown, haciendo pasar el código del archivo .md al lenguaje de marcado universal HTML.

Hay muchas aplicaciones disponibles, de hecho, en la actualidad. Casi todos los software comienzan a reconocer y permitir el uso de Markdown.

Las aplicaciones pueden ser desde simples scripts hasta aplicaciones de escritorio mucho más complejas, e incluso parecidas a la archiconocido procesador de textos: Microsoft Word.

A pesar de las diferencias visuales, todas las aplicaciones hacen lo mismo, al igual que Dillinger. Las aplicacione convierten el texto con formato Markdown a HTML para que pueda mostrarse a través de los navegadores web.

Las aplicaciones de Markdown usan algo llamado procesador de Markdown (también conocido como “analizador” o “implementador”) que es capaz de tomar el texto con formato Markdown y transformarlo a HTML.

En ese momento, el documento puede verse en un navegador web o combinarse con una hoja de estilos e imprimirse; se puede ver una representación visual de este proceso a continuación.

Podríamos resumir este proceso en 4 pasos:

  1. Crear un archivo de Markdown con un editor de texto o una aplicación de Markdown dedicada, el archivo debe tener una extensión .md o .markdown.
  2. Abrir el archivo de Markdown en una aplicación capaz de leer Markdown.
  3. Utilizar la aplicación de Markdown para convertir el archivo Markdown en un documento HTML.
  4. Ver el archivo HTML en un navegador web o usar la aplicación Markdown para convertirlo a otro formato de archivo, como PDF.

Este proceso puede variar levemente según la aplicación que se utilice. Por ejemplo, Dillinger, esencialmente combina los pasos del 1 al 3 en una única interfaz: todo lo que tienes que hacer es escribir en el panel izquierdo y la salida renderizada aparecerá mágicamente en el panel derecho.

Pero si usa otras herramientas, como un editor de texto con un generador de sitio web estáticos, encontrarás que el proceso es mucho más visible.

¿Para qué sirve Markdown?

Markdown es una forma rápida y fácil de tomar notas, crear contenido para un sitio web y producir documentos listos para imprimir.

No toma mucho tiempo aprender la sintaxis de Markdown, y una vez que sepa cómo usarla, puede escribir usando Markdown en casi todas partes. La mayoría de la gente usa Markdown para crear contenido para la web, pero Markdown es bueno para formatear todo, desde mensajes de correo electrónico hasta listas de compras.

A continuación, se muestran algunos ejemplos de lo que puede hacer con Markdown.

La creación de sitios web con Markdown

Markdown fue diseñado para la web, por lo que no debería sorprendernos que haya muchas aplicaciones diseñadas específicamente para crear contenido de sitios web.

Si estás buscando la forma más sencilla posible de crear un sitio web con archivos Markdown, consulta Githubes Pages.

Después de registrarse en uno de estos servicios, creando una carpeta de documentos en tu computadora, y simplemente arrastrar y soltar tus archivos Markdown dentro del proyecto de Github. No podría ser más sencillo.

Si está familiarizado con HTML, CSS y el control de versiones, no dudes en consultar Jekyll, un popular generador de sitios estáticos que toma los archivos Markdown y crea un sitio web HTML. como por ejemplo: ciberninjas.com.

Una ventaja de este enfoque es que GitHub Pages proporciona alojamiento gratuito para sitios web generados por Jekyll; y si Jekyll no es lo tuyo, simplemente puedes elegir otro de los muchos generadores de sitios estáticos disponibles.

Si desea utilizar un sistema de gestión de contenido (CMS) para impulsar su sitio web, también puedes echar un vistazo a Ghost. Que es una plataforma de blogs gratuita y de código abierto con un buen editor de Markdown.

Si eres un usuario de WordPress, te alegrará saber que hay soporte de Markdown para los sitios web alojados en WordPress.com; y los sitios de WordPress autohospedados, pueden usar el complemento Jetpack o bien, un plugin adecuado para ello.

Markdown no tiene todas las comodidades de los procesadores de texto como Microsoft Word, pero es lo suficientemente bueno para crear documentos básicos como tareas y cartas.

Puede utilizar una aplicación de creación de documentos Markdown para crear y exportar documentos con formato Markdown a formato de archivo PDF o HTML. La parte PDF es clave, porque una vez que tiene un documento PDF, puede hacer cualquier cosa con él: Imprimirlo, enviarlo por correo electrónico o cargarlo en un sitio web.

Aquí hay algunas aplicaciones de creación de documentos de Markdown que recomiendo:

Consejo: iA Writer proporciona plantillas para obtener una vista previa, imprimir y exportar documentos con formato Markdown. Por ejemplo, la plantilla “Académico - Estilo MLA” sangra los párrafos y agrega doble espacio entre oraciones.

La creación de notas con Markdown

En casi todos los sentidos, Markdown es la sintaxis ideal para tomar notas. Lamentablemente, Evernote y OneNote , dos de las aplicaciones de notas más populares, actualmente no son compatibles con Markdown. La buena noticia es que varias otras aplicaciones de notas son compatibles con Markdown:

  • Simplenote es una aplicación básica gratuita para tomar notas disponible para todas las plataformas.
  • Notable es una aplicación para tomar notas que se ejecuta en una variedad de plataformas.
  • Bear es una aplicación similar a Evernote disponible para dispositivos Mac e iOS. No usa exclusivamente Markdown de forma predeterminada, pero puede habilitar el modo de compatibilidad de Markdown.
  • Boostnote se anuncia a sí mismo como una “aplicación de código abierto para tomar notas diseñada para programadores”.

Si no puedes separarte de Evernote, puedes probar la aplicación Marxico, un editor de Markdown basado en suscripción para Evernote, o puedes usar Markdown Here con el mismo sitio web de Evernote.

La creación de libros con Markdown

¿Estás buscando autoeditar una novela? Prueba Leanpub, un servicio que toma tus archivos con formato Markdown y los convierte en un libro electrónico. Leanpub genera tu libro en formato de archivo .PDF, .EPUB y .MOBI.

Si deseas crear copias de libros de bolsillo, puedes cargar el archivo PDF en otro servicio como Kindle Direct Publishing.

Para obtener más información sobre cómo escribir y autoeditar un libro con Markdown, lee la publicación del siguiente blog, que trata sobre herramientas open source para autoeditar tu libro.

La creación de presentaciones con Markdown

Lo crea o no, puede generar presentaciones a partir de archivos con formato Markdown. Crear presentaciones en Markdown requiere un poco de tiempo para acostumbrarse, pero una vez que lo dominas, es mucho más rápido y fácil que usar una aplicación como PowerPoint o Keynote. Remark (proyecto GitHub) es una popular herramienta de presentación de diapositivas Markdown basada en navegador, al igual que Cleaver (proyecto GitHub). Si usa una Mac y prefiere usar una aplicación, consulte Deckset o Marked.

La creación de correos electrónicos con Markdown

Si envía mucho correo electrónico y está cansado de los controles de formato disponibles en la mayoría de los sitios web de proveedores de correo electrónico, le alegrará saber que hay una manera fácil de escribir mensajes de correo electrónico con Markdown. Markdown Here es una extensión de navegador gratuita y de código abierto que convierte texto con formato Markdown en HTML que está listo para enviar.

La creación de documentación con Markdown

Markdown es un ajuste natural para la documentación técnica. Empresas como GitHub están cambiando cada vez más a Markdown para su documentación: consulte la publicación de su blog sobre cómo migraron su documentación con formato Markdown a Jekyll.

Si escribe documentación para un producto o servicio, eche un vistazo a estas útiles herramientas:

  • Read the Docs puede generar un sitio web de documentación a partir de sus archivos Markdown de código abierto. Simplemente conecte su repositorio de GitHub a su servicio y presiona - Read the Docs hace el resto.
  • MkDocs es un generador de sitios estáticos rápido y simple que está orientado a la creación de documentación de proyectos. Los archivos de origen de la documentación se escriben en Markdown y se configuran con un solo archivo de configuración YAML. MkDocs tiene varios temas integrados, incluido un puerto del tema de documentación Leer los documentos para usar con MkDocs. Uno de los temas más nuevos es MkDocs Material.
  • Docusaurus es un generador de sitios estáticos diseñado exclusivamente para crear sitios web de documentación. Admite traducciones, búsqueda y control de versiones.
  • VuePress es un generador de sitios estáticos impulsado por Vue y optimizado para escribir documentación técnica.
  • Jekyll se mencionó anteriormente en la sección de sitios web, pero también es una buena opción para generar un sitio web de documentación a partir de archivos Markdown..

Sabores de Markdown

Uno de los aspectos más confusos del uso de Markdown es que prácticamente todas las aplicaciones de Markdown implementan una versión ligeramente diferente de Markdown. Estas variantes de Markdown se conocen comúnmente como sabores. Es su trabajo dominar cualquier versión de Markdown que haya implementado su aplicación.

Para entender el concepto de los sabores de Markdown, podría ser útil pensar en ellos como dialectos del idioma. La gente de Ciudad Juárez habla español al igual que la gente de Barcelona, pero existen diferencias sustanciales entre los dialectos utilizados en ambas ciudades. Lo mismo ocurre con las personas que utilizan diferentes aplicaciones de Markdown.

En términos prácticos, esto significa que nunca se sabe exactamente qué quiere decir una empresa cuando dice que apoya “Markdown”. ¿Están hablando solo de todos los elementos de sintaxis básica y la sintaxis avanzada combinados, o de alguna combinación arbitraria de elementos de sintaxis? No lo sabrá hasta que lea la documentación o comience a usar la aplicación.

Si recién está comenzando, el mejor consejo que puedo darle es que elija una aplicación de Markdown con un buen soporte de Markdown. Eso contribuirá en gran medida a mantener la portabilidad de sus archivos Markdown. Es posible que desee almacenar y usar sus archivos Markdown en otras aplicaciones y, para ello, debe comenzar con una aplicación que brinde un buen soporte.

Recursos adicionales de Markdown

Hay muchos recursos que puede utilizar para aprender Markdown. Aquí hay algunos otros recursos introductorios:

Hablemos de Markdown

Opinión Personal.

Markdown es muy simple de aprender, fácil y rápido de usar. Escribir Markdown es casi siempre más rápido que escribir con un editor de texto enriquecido, especialmente cuando comienzas a acceder a cosas como enlaces o listas con viñetas, que te hacen usar el mouse o te obligan a memorizar una secuencia complicada de atajos de teclado.

Una advertencia es que si necesita elementos de texto complicados, como tablas, es mejor quedarse con HTML; aunque en la actualidad también existen páginas con las que podemos transformar contenido en una tabla de Markdown. Markdown tiene soporte HTML completo, por lo que puede codificar una tabla en HTML y volver a Markdown en el mismo documento.

En resumen, es mucho más fácil leer Markdown sin formato que leer HTML sin formato. Lo que, ya sabes, es gran parte de la razón por la que incluso se inventó Markdown.

Es fácil y sencillo convertir Markdown en HTML

Si estás escribiendo un correo electrónico o un archivo README donde necesitas las opciones de formato HTML pero no la amplitud completa de sus características, Markdown es perfecto.

Markdown se convierte a HTML sin problemas, evitando la molestia de abrir y cerrar todas esas etiquetas. Entonces. Mucho mejor dejar las etiquetas de lado, y usar algo mil veces más útil, práctico y rápido.

De hecho, con Markdown tendrás software para convertir entre texto plano, HTML y Markdown sin ningún problema. Así que Markdown es en realidad un software de conversión de texto a HTML, aparte de ser un lenguaje de marcado.

Además, ¿Alguna vez has intentado convertir un archivo .docx a HTML? A menudo obtienes tanto formato y espacio extra que no vale la pena el esfuerzo.

Markdown ha venido para quedarse

Cuando cito “a prueba de futuro” quiero decir que Markdown es un formato de texto pero sin formato. Mientras el texto plano sea el estándar (que será por mucho tiempo) Markdown será utilizable y se podrá abrir con un sinfín de programas modernos y cada día que pasa; más software lo irán aceptando.

Por ejemplo, en comparación con Microsoft Word, que tiene 8 tipos de formato de archivos diferentes; la idea de mantener tus escritos en texto plano te va a asegurar que nunca habrá una versión desactualizada, por lo que el software no necesita actualizarse para mantener, mover, publicar o compartir tu contenido.

Markdown tiene su propia extensión de nombre de archivo: .md, pero fue diseñado para ser perfectamente legible como un archivo de texto sin formato. Por lo tanto, se podría decir que Markdown no cambiará en un futuro.

Markdown se puede usar en cualquier parte

Se podría esperar que el uso de Markdown se estancará a medida que el texto enriquecido se ha ido volviendo cada vez más popular, pero nada más lejos de la realidad. La presencia de Markdown no ha hecho que crecer desde su aparición y continúa usándose cada vez más.

Markdown, es el estándar no oficial en sitios de codificación populares como GitHub; también es la opción de formato predeterminada para herramientas de comunicación populares como Skype, Slack y (en menor medida) Facebook Messenger. Wikipedia incluso utiliza una sintaxis de Markdown modificada que llaman wikitexto y existen plugins para Wordpress y todos los editores de código e IDE´s que se te puedan ocurrir.

Dentro del mundo de la programación, que cada día vemos más incluido dentro de la sociedad en general; el programador que no conoce Markdown se encontrará en desventaja (e incluso pueda llegar a estar confundido por un tiempo).

Así que será mejor que aprendas Markdown y si no es por ninguna otra razón; que sea por el mero hecho de no quedarte atrás en el mundillo.

Con Markdown no es necesario que cambies de editor para escribir en prosa

Escribir en prosa puede ser un poco complicado, si lo haces dentro de un editor de código o texto. No es que no se pueda hacer, pero el texto sin formato elimina muchas de las opciones de formato que suelen ser útiles al escribir en prosa.

Esto es más un pequeño inconveniente que un gran problema, pero sigue siendo suficiente para que muchas personas prefieran cambiar a su programa de correo electrónico para escribir un correo electrónico o a su procesador de textos para escribir en prosa, en lugar de utilizar su editor de código habitual.

Con la introducción de Markdown, escribir un correo electrónico o blog dentro desde tu editor de código es perfectamente viable y eso es genial, porque ofrecer una mayor gama de posibilidades a los usuarios siempre es hacerles la vida un poco más fácil.

Si aún no has probado nunca a escribir en Markdown, comienza a hacerlo desde hoy; a continuación tienes editores en los que empezar a probar y con los que comenzar a ser un fanático la escritura en Markdown.

Editores Markdown » Chuleta Markdown » Cursos Markdon

Relacionados

▷ Los Mejores Editores de Texto GRATIS para PROGRAMAR en 2021

▷ 11 Mejores Editores de Código de Python y entornos de desarrollo IDE 2021

▷ Los 11 Mejores Editores de Código PHP y Entornos de Desarrollo 2021

▷ Gitpod: Plataforma IDE en la nube de código abierto

▷ Segunda actualización de Java para Visual Studio Code en 2020

🛒 Los Mejores Chollos de Amazon, ¡Agrégalos a tu Lista de Deseos!

Una descripción general de Markdown, cómo funciona y qué puede hacer con él