Markdown#
¿Qué es Markdown?#
Markdown es un lenguaje de marcado ligero que Jupyter y otros servidores como GitHub usan para intepretar texto decorado. Se ha popularizado porque ha resultado ser un buen consenso en cuanto a un conjunto de normas para la edición en texto plano y así como para su traducción a texto decorado mostrado por webs y aplicaciones. Te preguntarás, ¿por qué es esto necesario? Compartir ficheros de texto plano escritos en un lenguaje de marcado resulta conveniente, siempre será más barato manejar y transferir por la red ficheros de texto plano por su pequeño tamaño.
Para entender como funciona un lenguaje de marcado como Markdown, pongamos unos ejemplos. Veamos cómo marcar texto en cursiva, negrita o ambas:
*cursiva*
**negrita**
***cursiva y negrita***
cursiva
negrita
cursiva y negrita
A continuación puedes ver cómo se escribe una tabla en Markdown:
| item | prize | amount | total |
| ---- | ----- | ------ | ----- |
| A | 3.0 | 2 | 6.0 |
| B | 1.5 | 3 | 4.5 |
item |
prize |
amount |
total |
|---|---|---|---|
A |
3.0 |
2 |
6.0 |
B |
1.5 |
3 |
4.5 |
O un texto encerrado en una caja a modo de cita:
> This is a quote
This is a quote
Y por último, un enlace en este caso a otra web:
Si quieres saber más sigue [este enlace](https://www.markdownguide.org/getting-started/).
Si quieres saber más sigue este enlace.
¿Cómo se usa?#
Te recomendamos que eches un vistazo a cualquiera de las webs propuestas en la sección «Más recursos útiles». Encontrarás las mismas listas de ejemplos describiendo la sintaxis. Si tuvieramos que recomendar únicamente dos, propondríamos los siguientes enlaces. El primero por ser de John Gruber, uno de los creadores de Markdown. El segundo por parecernos una de las guias más completas para quien descubre Markdown por primera vez.
Ten en cuenta que algunos servidores o aplicaciones pueden tener sus peculiaridades así que siempre es mejor echarle un ojo a la documentación específica, por ejemplo de Jupyter o GitHub:
Dudas, problemas técnicos y soluciones.#
Para compartir con nosotros y con el resto de participantes las dudas, problemas, sugerencias o soluciones, que pudieras tener sobre el uso de Markdown y esta sección, te proponemos usar la siguiente discusión en este repositorio:
Más recursos útiles#
El propósito de esta unidad es ser un documento únicamente introductorio. Puedes encontrar -o contribuir añadiendo- más información útil en los siguientes listados de «Documentación» y «Tutoriales, webinars y cursos gratuitos»
Documentación#
No existe una documentación oficial sobre Markdown. Lo más parecido podría ser la web de uno de sus creadores, John Gruber:
Échale un ojo a la siguiente sección para encontrar más recursos útiles para aprender a usar Markdown.
Tutoriales, webinars y cursos gratuitos #
Aquí encontrarás una lista de tutoriales, videos o cursos gratuitos que puedes visitar para aprender más sobre Mardown.