Art铆culos, tutoriales y noticias de Markdown
Art铆culos, tutoriales y noticias de Markdown
  • Autor de la entrada:
  • Tiempo de lectura:24 minutos de lectura

Esta 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 capaz de formatear pr谩cticamente cualquier tipo de documentos.

Antes de nada, 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. El creador de Markdown es John Gruber y naci贸 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, cuando creas 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 en muchos sitios web, a pesar de no darte cuenta. Por ejemplo, en el chat de Facebook, Skype o Reddit te permiten usar diferentes tipos de Markdown con los que 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; 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 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