Cómo trabajar con GitHub Flavored Markdown en Linux

Markdown. es un lenguaje de formato que se crea para la web. El propósito de Markdown es facilitar la vida cuando escribimos en Internet. Con el tiempo, se crean muchos tipos de rebajas. Pero en este artículo, nuestro enfoque estará principalmente en Github Flavored Markdown (GFM).

Github. se basa en CommonMark. Hay muchas funciones adicionales admitidas en GFM como tablas, vallas de código, etc. Vamos a entrar y explorar la sintaxis de GFM y cómo usarlo en diferentes casos.

Estoy usando VScode para demostrar esto pero puede elegir cualquier editor de Linux que sea adecuado para usted. Algunos editores como Atom y Vscode vienen con soporte de Markdown y para algunos editores, necesitamos instalar un complemento de Markdown.

Para trabajar con Markdown, el archivo debe guardarse con .md o .markdown como extensión.

Cómo agregar encabezados al editor de Markdown

Hay 6. niveles de encabezado admitidos en Markdown. Para crear un encabezado, use el símbolo Hash (#) seguido de un espacio y el nombre del encabezado. Cuanto mayor sea el valor hash, menor será el tamaño del encabezado.

freestar.config.enabled_slots.push

NOTA. H1. y H2. tendrán un estilo de subrayado por defecto.

# Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 # ##### Encabezado 6 Agregar encabezados Add Headings

A veces, es posible que desee alinear el encabezado hacia el centro. Pero la triste historia es que la alineación no se admite de forma predeterminada en las rebajas. De forma predeterminada, los títulos se representan con alineación a la izquierda. Puede incrustar etiquetas HTML/CSS dentro del markdown para lograr la alineación.

MARKDOWN

MARKDOWN

MARKDOWN

MARKDOWN

 Encabezados Allignmen ts Alineaciones de encabezados

Cómo agregar comentarios al editor de Markdown

Los comentarios son una forma de documentar ciertas cosas para una mejor comprensión del código/Documentos. Esto no será procesado por el motor de rebajas.

<!-Bloque de comentarios->  Agregar comentarios al editor Agregar comentarios al editor

Cómo reproducir er Texto como una sola línea

Normalmente, cuando escribe algo en líneas separadas una tras otra, la rebaja lo representará como una sola línea.

 Texto en una sola línea Texto en una sola línea

Puede crear saltos de línea de dos formas.

  • Salto de línea suave
  • Saltos de línea dura

Saltos de línea suaves. se pueden crear agregando dos espacios al final de la línea. De esta manera, la rebaja convertirá cada línea en líneas separadas.

 Salto de línea suave Salto de línea suave

Saltos de línea dura. se puede crear insertando una línea vacía entre cada línea.

 Hardline Break Hardline Break

Cómo agregar líneas horizontales

La regla horizontal. se puede crear colocando tres o más asteriscos (*). guiones (-). o guiones bajos (_). en una sola línea. También está bien agregar espacio entre ellos.

* * *—___  Agregar líneas horizontales  Agregar líneas horizontales Agregar líneas horizontales Cómo poner un texto en negrita

Para hacer una palabra o líneas en NEGRITA. rodee la palabra o líneas entre asteriscos dobles (**) o subrayado doble (__).

** Poner esta oración en negrita usando asteriscos dobles. ** __ Poner esta oración en negrita usando doble subrayado .__ Negrita una línea o texto Negrita una línea o texto

Cómo hacer un texto en cursiva

Para hacer palabras o líneas ITALICAS. rodee la palabra o líneas entre asteriscos simples (*) o guiones bajos simples (_).

* Hacer esta línea poner en cursiva con asteriscos. * _Hacer que esta línea se ponga en cursiva con guión bajo._  Hacer texto en cursiva Hacer texto en cursiva

Cómo agregar un tachado a las líneas

Para tachar cualquier cosa, debe usar una tilde doble. Rodea todo lo que necesites tachar entre tildes dobles (~~).

Solo estoy tocando la palabra ~~ Hola ~~. ~~ Estoy tachando toda la línea. ~~  Agregar tachado a las líneas Agregar cadena ike-Through a líneas

Cómo agregar una cita en bloque

Use Mayor que un símbolo (>) para la cita en bloque.

Cita en bloque de una sola línea. Cita de una sola línea Cotización de una sola línea

Vea cómo se representa la cita de bloque a continuación. Ambas líneas se representan en la misma línea.

primera línea> Segunda línea> Tercera línea> Cuarta línea Múltiple Cotizaciones de línea Cotizaciones de varias líneas

Puede usar retorno de línea dejando dos espacios al final de cada línea. De esta manera, cada línea no se representará en una sola línea.

 Renderizar cotización en una sola línea Renderizar cotización en una sola línea

Deje las líneas alternas vacías con el prefijo mayor que un símbolo. De esta manera puede crear un salto de línea entre cada línea dentro del mismo bloque.

primera línea>> Segunda línea>> Tercera línea>> Cuarta línea  Agregar salto de línea Agregar salto de línea

También puede crear comillas de bloque anidadas agregando dos símbolos mayores que (>>).

 Cotizaciones de bloques anidados Cotizaciones de bloques anidados

Crear código en línea

Utilice BACKTICK. para crear código en línea. El siguiente ejemplo demuestra cómo crear código en línea. Mire las notas de palabras y el archivo Léame, que se representó como código en línea.

Markdown es una de las mejores herramientas para tomar “notas” y crear archivos “Léame”. Agregar código en línea Agregar código en línea

Agregar resaltado de sintaxis de bloque de código

Agregar pestañas o 4 espacios y coloque su código para representarlo como un bloque de código. Alternativamente, coloque su código entre tres comillas invertidas para hacer que el bloque se represente como un bloque de código. La característica importante que debe tenerse en cuenta aquí es el resaltado de sintaxis. Normalmente, cuando coloca el código dentro del bloque, no se le aplica ningún esquema de color.

“ `echo” Hola mundo “` “

Ahora mira el mismo ejemplo, el esquema de color se aplica automáticamente. Esto es posible agregando el nombre del lenguaje de programación después de tres comillas invertidas que aplicarán el esquema de color al código.

“ `bash echo” Hola mundo “` “  Resaltado de sintaxis Resaltado de sintaxis

Ejemplo de código Python.

` “ python def fp (): print (“Hello World !!! “) fp ()` “  Código Python Código Python

Ejemplo de consulta SQL.

` “ sql SELECT MAX (SALARY_EMP) FROM EMPLOYEE_TABLE WHERE SALARY_EMP <(SELECT MAX (SALARY_EMP) FROM EMPLOYEE_TABLE) “  Código de consulta SQL Código de consulta SQL

Crear listas ordenadas y desordenadas

Los elementos se pueden organizar en listas ordenadas y listas desordenadas en rebajas. Para crear una lista ordenada, agregue números seguidos de un punto. La parte interesante a tener en cuenta aquí es que el número no necesita ser secuencial. El motor de Markdown es lo suficientemente inteligente como para comprender que es una lista ordenada incluso si hacemos el orden no secuencial.

En el siguiente ejemplo, puede ver que creé una lista ordenada con un orden no secuencial (10, 15, 150) pero el motor de rebajas lo muestra en el orden correcto. También puede crear una lista anidada como se muestra en la imagen.

 Crear lista ordenada Crear lista ordenada

Para crear lista desordenada use el signo más (+) asteriscos (*) o guión (-) seguido de un espacio y el contenido de la lista. De manera similar a la lista ordenada, aquí también puede crear una lista anidada.