Una guía para principiantes sobre Markdown: todo lo que necesita saber para comenzar

Tabla de contenido

• ¿Qué es el descuento?
  • Ventajas de utilizar Markdown
• Comenzando con Markdown
  • Formato básico en Markdown
  • Formato avanzado en Markdown
• Aplicaciones del mundo real en Markdown
• Recursos

La capacidad de presentar sus pensamientos e ideas de forma clara y concisa es importante independientemente de la industria en la que trabaje. Afortunadamente, existe una gran cantidad de herramientas y tecnologías que ayudan a crear un buen contenido de texto.

Ingrese a Markdown, un lenguaje de marcado versátil pero sencillo que se ha convertido en un elemento básico para escritores, programadores y creadores de contenido de todo tipo.

Si eres nuevo en el ámbito de Markdown, no temas; Esta guía está diseñada para ser su brújula en el camino hacia el dominio de este lenguaje de marcado fácil de usar.

¿Qué es la rebaja?

Markdown es un lenguaje de marcado ligero que simplifica el proceso de formatear texto para la web y otros medios. Fue creado por John Gruber y Aaron Swartz en 2004 como una forma de escribir contenido que se pueda convertir fácilmente a HTML y otros formatos sin requerir amplios conocimientos técnicos.

Es particularmente popular entre escritores, blogueros, programadores y cualquiera que necesite una forma sencilla y eficaz de formatear texto para la web.

Ventajas de utilizar Markdown

1. Simplicidad y legibilidad: Markdown utiliza una sintaxis sencilla que utiliza caracteres de texto sin formato. Esta simplicidad hace que sea fácil de aprender y usar, permitiéndole centrarse en el contenido en sí en lugar de códigos de formato complejos.

2. Independencia de la plataforma: Markdown es independiente de la plataforma. Puede crear documentos Markdown en cualquier dispositivo utilizando un editor de texto o un editor de código, y estos documentos se pueden ver y convertir fácilmente a varios formatos en diferentes plataformas. Esta coherencia garantiza la accesibilidad y la longevidad de su contenido.

3. Curva de aprendizaje rápido: Markdown tiene una de las sintaxis más sencillas. Esto significa que puedes aprenderlo en poco tiempo. La sintaxis es intuitiva y se asemeja al formato que quizás ya use en correos electrónicos o mensajes de texto.

Esta rápida curva de aprendizaje fomenta la adopción por parte de aquellos que no son usuarios técnicos.

4. Amplia adopción: Markdown ha ganado una inmensa popularidad y es compatible con multitud de plataformas, incluidos sistemas de blogs como WordPress, herramientas de colaboración como GitHub y sistemas de gestión de contenidos. Esto convierte a Markdown en una habilidad valiosa que se puede aplicar en muchos contextos.

5. Velocidad y eficiencia: la creación de contenido en Markdown es rápida y eficiente. Con algunos caracteres simples y otros elementos de formato. Esto, a cambio, permite a sus usuarios elaborar documentos con sencillez, eficiencia y rapidez.

6. Control de versiones: cuando se utiliza Markdown en colaboración con sistemas de control de versiones como Git, los cambios realizados en los archivos Markdown son fáciles de rastrear. Esto simplifica la colaboración en proyectos, revisar cambios y mantener un registro claro de las ediciones.

Comenzando con Markdown

Markdown funciona en una variedad de editores de texto y editores de código. Por el bien de este artículo, nos centraremos en el uso de Markdown en editores de código, particularmente VS Code . Aunque se puede seguir la misma sintaxis en los editores de texto.

1. En primer lugar, en su código VS, cree una carpeta (puede nombrarla como desee). En esa carpeta, cree un archivo llamado markdown.md

   
   

2. Navegue a la sección superior derecha de su archivo VS Code y haga clic en el botón de vista previa para obtener una vista previa de su resultado uno al lado del otro.

   

Formato básico en Markdown

Estas son algunas de las sintaxis básicas para formatear texto en Markdown.

1. Encabezados : los encabezados se utilizan para indicar diferentes niveles de encabezado en su documento. Para crear encabezados en Markdown, use el símbolo # seguido de un espacio y luego el texto del encabezado. Tenga en cuenta que la cantidad de símbolos # determina los niveles de su título. Vea el ejemplo a continuación.

    # Heading ## Heading ### Heading 

   

2. Énfasis: Puede agregar énfasis a su texto poniéndolo en negrita o cursiva. Para poner el texto en negrita, enciérrelo entre asteriscos dobles ** o guiones bajos dobles __ . Para poner el texto en cursiva, enciérrelo entre asteriscos simples * o guiones bajos simples _ .

Ejemplo:

 This is the **Bold Text** This is *italics* 

3. Listas: Markdown admite listas tanto ordenadas (numeradas) como desordenadas (con viñetas). Para crear una lista ordenada, comience cada elemento con un número seguido de un punto. Para crear una lista desordenada, utilice un asterisco * , más + o guiones - .

Ejemplo:

 Ordered List: 1. First item 2. Second item 3. Third item Unordered List: * Item 1 * Item 2 * Item 3 

4. Enlaces: puede crear hipervínculos en Markdown usando corchetes [] para el texto del enlace y paréntesis () para la URL del enlace.

Ejemplo:

 [Visit Odafe's Website](https://www.odafe.vercel.app)

5. Imágenes: Insertar imágenes es similar a crear enlaces; ¡La única diferencia es un signo de exclamación ! delante de los corchetes. El texto alternativo entre corchetes se utiliza para describir la accesibilidad de la imagen.

Ejemplo:

 ![Alt text](image-url.jpg)

6. Blockquotes : Blockquotes se utilizan para mostrar textos de citas. Para crear esto, simplemente comience la línea con el símbolo > seguido del texto que desea citar.

Ejemplo:

 > This is a quote by Odafe

La salida se ve así:

Esta es una cita de Odafe.

7. Regla horizontal : puede agregar separadores horizontales simplemente usando tres guiones bajos _ .

Ejemplo:

 This is a regular text ____ This is more regular text 

Estos son los elementos fundamentales del formato básico en Markdown. Al dominar estos conceptos, podrá crear contenido bien estructurado y visualmente atractivo, ya sea que esté escribiendo una nota simple o elaborando un documento más complejo.

Formato avanzado en Markdown

Markdown también ofrece funcionalidad adicional en los casos en los que necesites agregar elementos más complejos a tu documento. Algunas de estas opciones de formato son:

1. Bloques de código y código en línea : puede agregar fácilmente bloques de código a su archivo comenzando sus bloques de código con tres comillas invertidas (```) seguidas del idioma en el que está escrito su bloque de código. Los códigos en línea se agregan ajustando el fragmento de código en comillas invertidas individuales.

Ejemplo:

 This is a HTML element `<div>Hello World</div>` ```javascript function myFunction() { console.log("Hello world!") } 

2. Listas de tareas: las listas de tareas son útiles para crear listas de tareas pendientes. Para crear una lista de tareas, utilice corchetes con una "x" para las tareas completadas y un espacio para las tareas incompletas.

Ejemplo:

 - [x] A complete task - [ ] An incomplete task 

3. Emojis : hay dos formas de agregar emoji a los archivos Markdown: copie y pegue el emoji en su texto con formato Markdown o escriba códigos cortos de emoji .

4. Texto tachado: para tachar texto, utilice tildes dobles ( ~~ ) alrededor del texto que desea tachar.

Ejemplo:

 This is a ~~Strikethrough~~ text.

5. Caracteres de escape: si necesita mostrar caracteres que tienen un significado especial en Markdown, puede escapar de ellos usando una barra invertida ( \ ).

 To display a literal asterisk \* use a backslash before it.

6. Superíndice y subíndice: para crear un superíndice, el texto del superíndice se envuelve entre dos símbolos ^ .

Para crear texto de subíndice, el texto se envuelve en dos símbolos ~ .

Ejemplos:

 This is how a superscript is written: X^2^ This is how a subscript is written: H~2~O. 

7. Tablas : para crear tablas en Markdown, siga estos pasos:

• Comience y finalice cada fila con un símbolo de tubería ( | ).
• Separe cada columna con un símbolo de barra vertical ( | ).
• Utilice tres o más guiones ( --- ) para crear encabezados de columna.

 | Syntax | Description | | ----------- | ----------- | | Header | Title | | Paragraph | Text |

Producción:

8. Resaltar : Puede resaltar palabras importantes en su documento usando dos signos iguales ( == ) antes y después de las palabras.

Ejemplo:

 This highlighted word is ==Bee==

Producción:

9. Notas al pie : Las notas al pie son una forma de agregar notas y referencias al final del documento sin saturar el cuerpo principal. Para crear una referencia de nota al pie, agregue un símbolo de intercalación ( ^ ) y un identificador único (generalmente números o palabras) entre corchetes ( [^1] ).

Los identificadores no pueden contener espacios ni tabulaciones. En el resultado, las notas a pie de página están numeradas secuencialmente.

Ejemplo:

 This is an example sentence with a footnote[^1]. [^1]: This is the content of the footnote.

La salida:

Puede obtener más información sobre el formato avanzado en Markdown aquí.

Aplicaciones del mundo real en Markdown

Markdown ha ganado mucha popularidad entre los desarrolladores de software y la comunidad de programación. En particular, ha encontrado un papel fundamental dentro de las plataformas de control de versiones, sirviendo como un medio completo y accesible para explicar la esencia de un código base.

Al emplear Markdown como conducto para describir las complejidades del código propio, los desarrolladores crean una combinación armoniosa de claridad y contexto.

Esta práctica extiende una mano amiga a aquellos que se topan con su repositorio de código, facilitando una comprensión rápida y profunda del propósito general y los matices del proyecto.

De esta manera, Markdown se presenta no sólo como una herramienta de formato sino también como un poderoso comunicador, que cierra la brecha entre los complejos esfuerzos de codificación y sus profundas implicaciones en el mundo real.

Conclusión

Recuerde, Markdown no es sólo una herramienta; es un puente que conecta sus pensamientos con una audiencia global, permitiendo que su voz se escuche con claridad e impacto.

Su compatibilidad con varias plataformas, su simplicidad y su adaptabilidad garantizan que su viaje con Markdown no se limite a esta guía, sino que continúe mientras explora nuevas formas de expresarse y expresar sus ideas.

Recursos

• Hoja de referencia: https://www.markdownguide.org/cheat-sheet/

• Tutorial: https://www.markdowntutorial.com/

• Tutorial: https://commonmark.org/help/tutorial/

  
  

También publicado aquí