Phenquestions
El Markdown estándar
Markdown es un estándar desarrollado por John Gruber. El objetivo principal de Markdown es hacer posible la lectura del archivo incluso en texto puro. Si desea buscar en un editor de solo texto, debería tener un tiempo fácil para leerlo. Esto es muy útil para los usuarios de vim y similares. Tenga en cuenta y recuerde que este es un estándar para cambiar archivos de texto. No reemplaza HTML. En su lugar, lo usa para crear HTML donde sea útil. En el caso de GitHub, formatearán el archivo Léame en el sitio. Siempre que siga el estándar, puede estar seguro de que se verá bien.
Dado que GitHub ha agregado solo algunas extensiones, debe comenzar usando una hoja de referencia de Markdown y continuar desde allí. Aquí tienes una lista de los más comunes.
| Reducción | Extensiones | Resultado |
| # (1 por nivel) | Encabezados | |
| * | Cursiva | |
| ** | Negrita | |
| > | Blockquote | |
| 1. (etc.) | Lista ordenada | |
| - | Lista desordenada | |
| 'código' | Tu codigo | |
| "' | Md-ext | Iniciar y finalizar un bloque de código |
| - | Regla horizontal | |
| [Descripción] (https: // www.ejemplo.com) | Un nombre en cuadrado y URL entre paréntesis regulares | |
| ![texto alternativo] (imagen.png) | Igual, enlace a una imagen | |
| [1] | Md-ext | Una nota a pie de página |
Las listas se pueden anidar sangrando los elementos que desee anidar.
Otras extensiones de Markdown regular, tienes las extensiones de bloques de código arriba. No siempre están respaldados por servicios.
| Reducción | Extensiones | Resultado |
| ### Encabezado # custom-id | Md-ext | Un encabezado que puede abordar por su ID |
| término: definición | Md-ext | Una lista de términos con definiciones |
| ~ Texto equivocado ~ | Md-ext | Texto tachado |
| - [x] Tarea por hacer | Md-ext | Una lista de tareas que puede marcar |
La tabla es muy simple, pero necesita varias filas para mostrarla: Tabla:
| Nombre | VALOR || ----------- | ---------- |
| Alfombrillas | 100 |
Extensiones de GitHub.
GitHub ha agregado algunas extensiones para simplificar el manejo de enlaces a otras personas y proyectos. Algunas de ellas son las tablas mencionadas anteriormente. La que más te ayudará es la extensión de enlace automático. Crea un enlace por sí solo cuando lo usa en GitHub.
Otros son tablas y elementos de la lista de tareas. Son convenientes para realizar un seguimiento de sus tareas en proyectos. El último en mencionar es la extensión HTML sin formato no permitida. Con la ayuda de esta extensión, algunas etiquetas se filtran al renderizar para HTML. Estas etiquetas pueden causar efectos extraños al renderizar en GitHub.
Formas de explorar GitHub Markdown
Si lo encuentra confuso, también puede ir a la página de GitHub y usar el editor incorporado. Cuando lo use, completará automáticamente algunas funciones. Esto solo funciona para problemas, pero puede usarlo para resolver algunas cosas, los emojis aparecen como una lista cuando escribe dos puntos (:).
También puede encontrar un proyecto en GitHub que tenga un archivo README de excelente apariencia y clonarlo en su unidad local. Desde allí, puede explorar el archivo usando cualquier editor que desee. Para los grandes editores, Emacs y Vim, hay soporte para markdown a través de extensiones.
Si está utilizando vim, puede poner una extensión de resaltado de sintaxis de GitHub, vim-markdown. Esta extensión te muestra que has hecho el código correctamente. Para ayudarlo a ver cómo se ve cuando termina, también puede obtener la extensión de marca en vivo. Con esto, puede tener un servidor web en ejecución, mostrando el resultado en vivo mientras escribe.
Con Emacs, tiene modo impaciente, modo inactivo en vivo y vista previa en tiempo real. Todos muestran su página resultante en un navegador mientras escribe. El primero requiere menos bibliotecas que el segundo, pero necesita un fragmento de código adicional para ejecutarse.
Conclusión
Aunque Markdown es una especificación pequeña y deliberadamente simple, puede ser un poco confuso comenzar con. La mejor manera de aprender es usar una hoja de referencia y escribir su documento Markdown. Puede actualizar su archivo README.md en GitHub, y puede obtener una gran cantidad de soporte de las funciones integradas de sus editores. Como nota al margen, GitHub también admite emojis que puede agregar a su documento. Puede usar la hoja de trucos para encontrar cuáles son.
Descargar Markdown-CheatSheet aquí
