Reducción

Markdown es un texto para la herramienta de conversión HTML. Hoy se ha convertido en el sinónimo de facto para una clase de lenguajes de descripción de marcado liviano. Utiliza una sintaxis de formato de texto plano. La idea detrás de Markdown era hacer que la escritura de páginas web y especialmente las entradas de blog sean tan fáciles como escribir un correo electrónico. Al momento de noviembre de 2017, se logra el objetivo y Markdown, así como sus derivaciones, Asciidoc, Asciidoctor y Asciidoctor-PDF están ampliamente en uso.

Markdown se centra solo en texto sin formato y se abstiene de todas las demás complejidades que se encuentran en HTML. Es fácil de aprender, ya que se mantiene simple, por lo tanto, también más rápido, ya que se usan caracteres mínimos, lo que conduce a menos posibilidades de un error al final también. Consulte la Figura 1 para obtener un documento básico que se muestra en el editor de Markdown StackEdit. En el lado izquierdo, ve el código fuente y en el lado derecho la salida HTML correspondiente. Puede notar que los titulares simplemente están marcados con una serie de #de acuerdo con el nivel de jerarquía del titular.

Conversión de texto

El texto sin formato es convertible en XHTML (HTML) y muchos otros formatos utilizando las herramientas de línea de comando como Markdown o Pandoc. Básicamente, ambas herramientas crean solo fragmentos HTML y escriben la salida a Stdout. PANDOC ofrece el interruptor "-o nombre de archivo" para escribir la salida HTML en el archivo dado. Como se ve a continuación, el archivo de salida se llama básico.html y contiene el fragmento html: dos titulares y un párrafo.

$ PANDOC -O BASIC.html básico.Maryland
$ Cat Basic.html

Creación de paquetes de Debian Howto

Prefacio

Ser responsable de una máquina significa cuidar el hardware y los componentes del software. Como se ve en la vida cotidiana como administrador del sistema, es mucho mejor instalar software como un paquete de software en lugar de un montón de archivos fuente. Esto reduce los costos para mantener adecuadamente el sistema.
ps

Para crear documentos HTML independientes con un encabezado HTML completo, PANDOC acepta el interruptor "-S" de la siguiente manera:

$ PANDOC -O BASIC.html -s básico.Maryland
$ Cat Basic.html

Creación de paquetes de Debian Howto

Prefacio

Ser responsable de una máquina significa cuidar el hardware y los componentes del software. Como se ve en la vida cotidiana como administrador del sistema, es mucho mejor instalar software como un paquete de software en lugar de un montón de archivos fuente. Esto reduce los costos para mantener adecuadamente el sistema.

La ventaja de mantener el contenido separado de su pantalla visual es que no arruinará el aspecto de su sitio. Versión 1.0.1, que fue desarrollado por John Gruber y Aaron Swartz se lanzó en diciembre de 2004 y está disponible como software gratuito (ver enlaces al final de este artículo).

Elementos de texto

Titulares

De acuerdo con el nivel HTML correspondiente, los titulares se escriben con una serie de #como sigue:

# H1
## H2
### H3
#### H4
##### H5
###### H6

Para H1 y H2 se aceptan dos formas de escritura alternativas:

H1
==
H2
--

Tenga en cuenta que el número de letreros o guiones iguales tiene que coincidir con los números de caracteres del titular.

Enfatizando el texto

Para enfatizar el texto, estos elementos son compatibles:

• cursiva: asteriscos individuales o subrayadores individuales
  --
  * importante* y _ también importante_
  --
• Texto en negrita: asteriscos dobles o subrayadores dobles
  --
  ** importante ** y __ también importante__
  --
• Texto cruzado: Tiltes dobles
  --
  ~~ texto ~~
  --

Liza

Markdown admite listas desordenadas y ordenadas. Las listas ordenadas comienzan con un asterisco, un signo más o menos. Listas ordenadas simplemente comience con un dígito. Para crear sublistas, sangren el listitem por dos espacios (Markdown, StackEdit) o ​​cuatro espacios (pandoc) como verá a continuación:

1. frutas
* manzana
* banana
2. bebidas
+ agua
+ leche

Imágenes

La forma más fácil es usar el estilo en línea de la siguiente manera:

![El logotipo de Debian] (Debian-logo.PNG "Logian logo")

Esto muestra la imagen referenciada. Tan pronto como mueva el puntero del mouse sobre la imagen, verá el texto de descripción correspondiente.

Resaltado de código y sintaxis

Hay dos variantes: código en línea y bloques de código. El código en línea se enmarca en tres backticks como "'Impresión (" Hola, mundo!")" ''. Los bloques de código también comienzan y terminan con tres retrocesos, pero en líneas separadas de la siguiente manera:

"
Imprimir ("Hola, mundo!")
"

Markdown no admite el resaltado de sintaxis, pero dialectos como Markdown aquí lo hacen.

Mesas

Markdown no admite tablas, pero extensiones como GFM y Markdown aquí.

Bloqueo

Blockquotes simplemente comienza con un signo ">". Se vuelve bastante útil citar texto.

> "Oh! Es absurdo tener una regla dura y rápida sobre lo que uno debería
> Leer y lo que no debería. Más de la mitad de la cultura moderna depende
> Sobre lo que uno no debe leer."
>
> La importancia de ser sincero. (Oscar Wilde)

Enlaces

Los enlaces se refieren a otros documentos o secciones en la actual. El estilo de escritura es similar al.

[Soy un enlace de estilo en línea] (https: // Linuxhint.com)

Además, puede agregar un texto alternativo:

[Soy un enlace de estilo en línea con texto adicional] (https: // linuxhint.com "Linuxhint")

Los enlaces se pueden hacer referencia de la siguiente manera:

[Linuxhint] [1]
…
algún texto
…
[1]: https: // Linuxhint.comunicarse

Esto le permite construir fácilmente listas de referencias al final de su documento, ya que es común en los documentos científicos.

Conclusión

Markdown es bastante simple y imprescindible para todos los que hacen documentación y publican regularmente contenido. Es un gran placer usarlo.

Referencias

• StackEdit, https: // Stackedit.IO
• Pandoc, http: // pandoc.org/
• Markdown, https: // Daringfireball.Net/Projects/Markdown/
• Markdown Cheatsheet, https: // github.com/adam-p/markdown-here/wiki/markdown-cheatsheet