¿Qué archivo usa la extensión .md y cómo debo editarlo?
En GitHub, varios proyectos tienen README.mdarchivos. Parece un archivo de formato simple para expresar texto e imágenes.
Supongo que hay un editor o una explicación de sintaxis en alguna parte.
¿ Dónde puedo encontrar una introducción a los .mdarchivos?
Markdown es un formato de archivo de texto sin formato. Las extensiones .mdy .markdownson solo archivos de texto escritos en sintaxis Markdown . Si tiene un Readme.mdrepositorio en su repositorio, GitHub mostrará el contenido en la página de inicio de su repositorio. Lea la documentación:
- Rebaja estándar
- Rebaja con sabor a GitHub
Puede editar el Readme.mdarchivo en el propio GitHub. Haga clic en Readme.md, encontrará un botón de edición. Puede obtener una vista previa de sus cambios e incluso confirmarlos desde allí.
Dado que es un archivo de texto, se puede utilizar Notepad o Notepad++ (Windows), TextEdit (Mac) o cualquier otro editor de texto para editarlo y modificarlo. Existen editores especializados que analizan automáticamente la rebaja a medida que la escribe y generan una vista previa, mientras que otros aplican varios colores de sintaxis y decoraciones al texto mostrado. Sin embargo, en ambos casos, el archivo guardado sigue siendo un archivo de texto legible.
Si desea crear un mdarchivo con vista previa y prefiere no instalar ningún editor especial, puede utilizar editores en línea como dillinger.io y stackedit.io . Proporcionan vista previa en vivo. También puedes exportar tus archivos a Google Drive o Dropbox .
Si está buscando un editor, le sugiero que utilice http://dillinger.io/ . Es un editor de texto simple basado en navegador que puede representar Markdown sobre la marcha.
Sin embargo, si prefieres una aplicación y estás usando OS X, puedes probar Mou . Es bastante bueno y lleno de ejemplos.
El editor de texto Atom de Github tiene un modo de vista previa en vivo para archivos de rebajas.
El atajo de teclado es CTRL+SHIFT+M.
Se puede activar desde el editor usando la CTRL+SHIFT+Mcombinación de teclas y actualmente está habilitado para archivos
.markdown,.md,.mkd,.mkdowny.ron.
El editor de texto Visual Studio Code de Microsoft tiene soporte integrado para archivos .md escritos en sintaxis de rebajas.
La sintaxis está codificada por colores automáticamente dentro del archivo .md, y se puede ver una ventana de vista previa de la reducción renderizada presionando Shift+Ctrl+V(Windows) o Shift+Cmd+V(Mac).
Para verlos uno al lado del otro, arrastre la pestaña de vista previa al lado derecho del editor o use Ctrl+K V(Windows) o Cmd+K V(Mac) en su lugar.
VS Code usa la biblioteca marcada para el análisis y tiene habilitada la compatibilidad con Github Flavored Markdown de forma predeterminada, pero no mostrará Github Emoji en línea como lo hace el editor de texto Atom de Github .
Además, VS Code admite varios complementos de rebajas disponibles para una funcionalidad ampliada.