Phenquestions
Al mismo tiempo, la rebaja es muy ligera y flexible. El caso de uso más popular para markdown es para archivos de licencia y README en un repositorio de GitHub, pero también se está integrando con más y más CMS para administrar publicaciones de blog e incluso escribir artículos de investigación. Puede renderizar ecuaciones matemáticas con complementos para LaTeX.
Es utilizado principalmente por desarrolladores, sin embargo. Es realmente útil para hacer tutoriales y documentación gracias al resaltado de sintaxis para varios idiomas y al soporte para imágenes e incluso gifs.
Comencemos con una configuración que nos permite obtener una vista previa del documento renderizado junto con un archivo de texto sin formato de rebajas.
Editor de texto Atom y vista previa de Markdown
Puede descargar e instalar Atom Text Editor o Visual Studio Code para seguir. Atom y VS Code tienen complementos preinstalados para Markdown Preview. Aquí se usará Atom, pero la sintaxis seguirá siendo aproximadamente la misma sin importar qué editor de texto use.
En Atom, asegúrese de que el paquete Markdown Preview esté habilitado (de hecho, está habilitado de forma predeterminada). Cree una carpeta para este tutorial de rebajas y, allí, abra un nuevo archivo (CTRL + N) e ingrese el siguiente texto allí.
# Este es un encabezado___
## Esto también es un encabezado
Aquí hay un texto
Guarde el archivo (CRTL + S) con un .extensión md. Por ejemplo, puede nombrar su archivo como prueba.md y el .La parte md le dirá a Atom que se trata de un archivo de rebajas y que la extensión funcionaría con él según lo previsto. Puede generar una vista previa utilizando la siguiente combinación de teclas (CTRL + MAYÚS + M) que se muestra en un nuevo panel al lado del archivo de texto sin procesar.
Puede cerrar el panel de vista previa utilizando la misma combinación de teclas o utilizando la propia GUI.
Con todo configurado, podemos echar un vistazo más de cerca a la sintaxis y comenzar a crear documentos increíbles sobre la marcha.
Sintaxis de Markdown
Como se mencionó anteriormente, la principal motivación detrás de Markdown es la legibilidad. Esto significa que no hay etiquetas oscuras o etiquetas anidadas o cualquier otra cadena que induzca a confusión. En su lugar, podemos comenzar con el símbolo '#' para indicar que esa línea en particular es un encabezado.
# Es un encabezado.## También indica el encabezado, pero con un tamaño de fuente más pequeño.
### Puede pasar a tamaños consecutivamente más pequeños
Saltos de línea
Markdown continúa agrupando todo el texto en un párrafo gigante incluso cuando el texto sin formato se divide en varias líneas diferentes. Para mitigar esto, puede usar dos espacios al final de una línea y luego poner un carácter de nueva línea (es decir, presionar
La oración "Por eso ..." comenzó en una nueva línea pero no está separada de la línea anterior, mientras que, al usar dos nuevas líneas, se creó una separación más amplia.
Regla horizontal
La regla horizontal, como su nombre indica, crea una línea horizontal que le permite estructurar su documento y hacer separaciones lógicas en él. Hay dos métodos para crear una regla horizontal. Primero es usar tres o más guiones bajos para crear una regla horizontal.
# Encabezado 1___
El párrafo y el encabezado están separados por una regla horizontal.
___
Otra sección separada
Otra opción (que no recomendaré) es usar tres o más guiones '-' pero también se usan para indicar que la oración inmediatamente encima de ellos es un encabezado. Entonces, si no tiene una nueva línea entre una oración y la regla horizontal debajo de ella, esa oración tomará la forma de un encabezado.
Cursiva, negrita y tachado
La sintaxis de los tres es bastante simple y habla por sí sola.
** Esto está en negrita **__ Esto también es en negrita__
_Esto es en cursiva_
* Esto también es cursiva *
~~ Esto está tachado ~~
Personaje de escape
Ahora, uno podría preguntarse, ¿cómo escribiría literalmente ** Algún texto ** en el archivo de rebajas final si solo cambia eso a negrita cada vez. Esto es algo con lo que también se ocupan la mayoría de los lenguajes de programación y la solución es similar a esas: use un carácter de barra invertida. Esto también funciona para otros elementos de sintaxis, y no es específicamente para estilos en negrita.
\ ** Esto ya no está en negrita \ **Si desea mostrar el carácter de barra invertida en sí, use dos de ellos y así sucesivamente.
\\ Aparece como una sola barra
Blockquotes y bloques de código
Blockquotes y bloques de código son mucho más fáciles. Se puede usar una cita en bloque para resaltar un punto importante hacia el que desea llamar la atención de los lectores. Esto se puede lograr usando el soporte angular derecho al principio como se muestra.
# Título 1Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud ejercicio ullamco laboris
nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor en reprehenderit en voluptate
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint Ocecat cupidatat non
proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
> Este es un resumen ordenado de una subsección de su documento. Un> par de líneas que se destacan
fuera del resto del contenido.
El contenido continúa.
Así es como se ve cuando se renderiza.
Para bloques de código, simplemente sangra las líneas con 4 espacios o más. Esto es realmente
útil para desarrolladores y operadores que quieran documentar su trabajo. Más tarde veríamos cómo hacer esto aún mejor.
Hipervínculos e imágenes
Para los hipervínculos, la sintaxis es bastante simple. El texto visible está escrito entre corchetes y la URL a la que apunta está escrita entre corchetes justo al lado.
Para las imágenes, la sintaxis es similar, excepto que comienza con un signo de exclamación. Puede usar una ruta relativa en la carpeta de su proyecto que apunte a la imagen o puede tener una URL pública.
## Ilustrando la sintaxis de HyperLink e Image___
Deberías [visitarnos] (https: // linuxhint.com) más a menudo
Así es como se incrustan las imágenes.
![SmugPug] (https: // subir.wikimedia.org / wikipedia / commons / d / d2 / Bonny_Bonita.JPG)
Mesas
Crear tablas en markdown incluye dibujar literalmente un retrato ascii (Unicode para ser precisos) de una tabla.
## Mesas| Columna 1 | Columna 2 | Columna 3 |
| --------- | --------- | --------- |
| Primera fila | Primera fila | Primera fila |
| Segunda fila | Segunda fila | Segunda fila |
No es necesario que la sintaxis esté alineada exactamente de una fila a otra, pero el carácter de barra vertical se usa para cambiar a la siguiente columna y la siguiente línea indica que la siguiente fila ha comenzado, generalmente.
Markdown extendido
Para aquellos de ustedes que han llegado tan lejos, aquí está el verdadero placer. Si está utilizando Atom, puede reemplazar el complemento Markdown Preview por Markdown Preview Plus. Que ofrece las siguientes funcionalidades.
1. Ecuaciones matemáticas usando LaTeX:
De hecho, puede insertar scripts LaTeX entre signos de dólar y se renderizará como script LaTeX y se mostrará en la vista previa con CTRL + SHITFT + combinación de teclas X. Ni siquiera tiene que conocer todo el LaTeX, solo unos pocos fragmentos son suficientes.
## Ilustrando LaTex___
$$ | \ Psi \ rangle = \ alpha | 0 \ rangle + \ beta | \ rangle $$
2. Resaltado de sintaxis
En lugar de usar sangría para indicar bloques de código, puede usar comillas invertidas seguidas del nombre de los idiomas en los que supuestamente está escrito su script. Los idiomas cuya sintaxis es compatible son demasiado numerosos para enumerarlos aquí, pero aquí hay un ejemplo en python.
## Ilustrando el resaltado de sintaxis___
"pitón
importar esto
def mi_función ():
print ("Hola, mundo!")
volver 0
"
Hay muchos sabores o rebajas. GitHub tiene su propia preparación especial y la sintaxis es muy flexible. No se supone que esto intimide a los usuarios, sino que atienda a una variedad más amplia de ellos. Es uno de esos lenguajes en los que uno simplemente entiende un subconjunto que uno necesita y lo usa, en lugar de molestarse por los tecnicismos (a menos que esté interesado en sus tecnicismos!)
