markdown

propósito

• notas sobre markdonw un proyecto de john gruber
• la intención de markdonw es ser una herramienta de conversion de texto a html
• el objetivo es que sea fácil de leer y de escribir como texto plano sin necesidad de trasformación.
  • una sintaxis de texto en formato plano
  • un software escrito en perl que transforma ese formato en html válido.
    • la misma página en formato markdown

NUEVE REGLAS SIMPLES

• sacado de un artículo sobre porque se debe usar Markdown
• estas son las nueve reglas básicas de uso

CommonMark

• CommonMarg es un intento de normalizar Markdown
• con un sitio online llamado Babelmark para comparar las diferentes salidas del un texto en markdown en diferentes sitios

kramdown

• kramdown es una librería para formatear y convertir markdown.
  • un editor online de kramdown
  • de un tal Daniel Perez Alvarez
  • una buena guía de GitLab
  • trucos para kramdown

TOC

• se puede generar un TOC con esta etiqueta

{% include toc.html %}

• una pega es que al dar formato al documento desde Visual Studio Code se crea un espacio en blanco

  {% include toc.html %}

• y esto hace que no funcione la etiqueta

cita a pie de página

• teclado¹.

teclado[^1].
[^1]: En Python 2.0, esta función se denominó `raw_input`.
[^2]: Consulte [http://en.wikipedia.org/wiki/Mnemonic](http://en.wikipedia.org/wiki/Mnemonic) para obtener una descripción ampliada de la palabra "mnemonic".

• se genera una cita con un 1 al lado de la palabra teclado con un enlace al pie de página donde esta la flecha para subir otra vez a la palabra teclado

utilidades

• una utilidad para visualizar un archivo Markdown en forma de mapa mental
  • sirve para hacer un mapa visual e interactivo de un documento Markdown
  • lo instalo en esta bitacora npm install markmap-lib -g
  • crea el mapa con el nombre del archivo.html y lanza el navegador para verlo
  • muy interesante
    • impresionante

enlaces

• manual Markdown
• editor de markdown simpleMDE
• chuleta propia para markdown
• chuleta para markdown TOC
• markdownEditingChuleta
• chuleta de markdownEditing
• http://joedicastro.com/pages/markdown.html
• aprende markdown de BitBucket
• Un visor de markdown para probar
  • 0.0.8-Marp-win32-x64.zip
  • para hacer presentaciones on diapositivas.
    • C:\portablesisorMarkdown
• editor dearkdown
• markdown para al correo electrónico
• para pasarlo a pdf markdown to pdf para convertir en la wev markdown to web

editores

• un editor open source
  • se puede descargar
  • buen editor con la tabla de contenidos en el lateral

PROBLEMAS

PROBLEMA AL GENERAR EL HTML DE LOS CHECKS

• problema con pues no se sale bien en el html generado
• tiene que ver con que haya o no una línea ente un y otro
  • tiene que ver con las líneas en blanco entre checks

# TITULO

* ahora esto
* [x] esto esta hecho
* [ ] y esto por hacer

* [x] la linea de separación de arriba hace que salga mal este check y el de arriba

# TITULO 1

* ahora esto
* [x] esto esta hecho
* [ ] y esto por hacer

# TITULO 2

* [x] esta es la forma de que salga bien después de una separación

• página con los códigos html como los que vienen a continuación
• alternativas

✅

✓

✗

☐ para no chequeado

☑ para chequeado

☒

☑️

🔲