Qué archivo uses.md extensión y cómo debo editarlos?


En GitHub, varios proyectos tienen archivos README.md. 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 archivos .md?

Author: entpnerd, 2011-05-07

15 answers

Las extensiones .md y .markdown son solo archivos de texto escritos en sintaxis Markdown. Si tienes un Readme.md en tu repositorio, GitHub mostrará el contenido en la página de inicio de tu repositorio. Lea la documentación:

Puedes editar el archivo Readme.md en GitHub. Haga clic en Readme.md, encontrará un botón de edición. Puede previsualizar sus cambios e incluso confirmarlos desde alli.

Dado que es un archivo de texto, se puede usar el Bloc de notas (Windows), TextEdit (Mac) o cualquier otro editor de texto para editarlo y modificarlo. Existen editores especializados que analizan automáticamente el markdown a medida que lo escribe y generan una vista previa, mientras que otros aplican varios colores de sintaxis y decoraciones al texto mostrado. En ambos casos, sin embargo, el archivo guardado sigue siendo un archivo de texto legible.

Si desea crear un archivo md con vista previa y si prefiere no instalar ningún archivo especial editores, puede usar editores en línea como dillinger.io y stackedit.io . Proporcionan una vista previa en vivo. También puedes exportar tus archivos a Google Drive o Dropbox .

 673
Author: Dikei,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2016-07-29 13:05:22

Si está buscando un editor, le sugiero que use http://dillinger.io / . Es un editor de texto simple basado en navegador que puede renderizar Markdown sobre la marcha.

Sin embargo, si prefiere una aplicación y está utilizando OS X, puede probar Mou. Es bastante bueno y lleno de ejemplos.

 80
Author: sirLisko,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-11-06 18:57:40

El editor de texto Atom de Github tiene un modo de vista previa en vivo para los archivos markdown. El atajo de teclado es CTRL+SHIFT+M.

Se puede activar desde el editor usando el enlace de claves CTRL+SHIFT+M y actualmente está habilitado para .markdown, .md, .mkd, .mkdown, y .ron archivos.

introduzca la descripción de la imagen aquí

 38
Author: Feckmore,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2016-01-24 07:42:36

El editor de texto de Microsoft Visual Studio Code ha incorporado soporte para archivos .md escritos en sintaxis markdown.

La sintaxis se codifica automáticamente por colores dentro del archivo .md, y se puede ver una ventana de vista previa del markdown renderizado presionando Shift+Ctrl+V (Windows) o Shift+Cmd+V (Mac).

Para verlos uno al lado del otro, arrastre la pestaña vista previa al lado derecho del editor, o use Ctrl+K V (Windows) o Cmd+K V (Mac) en su lugar.

introduzca la descripción de la imagen aquí

VS Code utiliza el marcada bibliotecapara el análisis, y tiene Github Con sabor Markdownsoporte habilitado de forma predeterminada, pero no mostrará el emoji de Github en línea como lo hace el editor de texto Atom de Github.

Además, VS Code supports tiene varios complementos de markdown disponibles para una funcionalidad extendida.

 18
Author: Feckmore,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2016-07-29 16:17:37

La extensión

'.md' se refiere a los archivos Markdown.

Si no desea instalar una aplicación para leerlos en ese formato, simplemente puede usar TextEdit o Xcode para abrirlo en Mac.

En cualquier otro sistema operativo, debería poder abrirlo usando cualquier editor de texto, aunque como era de esperar, no lo verá en formato Markdown.

 15
Author: codeburn,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-03-26 09:13:02

Sí, solo Markdown con sabor a GitHub. Incluir un archivo README en su repositorio ayudará a otros a determinar rápidamente de qué se trata y cómo instalarlo. Muy útil para incluir en sus repositorios.

 14
Author: esilvas,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2013-10-02 18:33:23

Stack Edit es un editor de markdown en línea con la capacidad de guardar en Google Drive y DropBox.

 5
Author: Philip,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-02-14 15:18:19

Markdown es solo un archivo de texto que opcionalmente tiene .md, o .markdown extensiones. Se puede convertir a HTML. Para conocer la sintaxis de Markdown, Echa un vistazo a

GitHub Flavored Markdown .

Puede usar cualquier editor de texto para markdown. Si eres usuario de sublime text, puedes consultar el complemento Markdown Preview que mostrará el contenido de markdown renderizado en el navegador y las actualizaciones cada vez que cambies el archivo de markdown.

Algunas de las rebajas en línea editor

 5
Author: Fizer Khan,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-03-06 06:32:42

BBEdit también mostrará MD en el mac.

Y aquí hay un complemento quicklook para mostrarlos cuando los previsualice.

 4
Author: nycynik,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2013-02-22 15:08:58

Markable.in es una herramienta en línea muy agradable para editar sintaxis Markdown

 2
Author: user1337432,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-05-29 19:37:09

Hay un esfuerzo continuo para estandarizar Markdown y a partir de ahora, este es probablemente el mejor lugar para aprender sobre markdown:

Http://standardmarkdown.com/

 2
Author: Afaque H,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2014-09-04 17:56:50

Sugiero StackEdit. Es simple editor WISIWIG. Puede usar la sintaxis editor y markdown. Hay una sintaxis de ayuda de markdown rápido allí. Deshacer / rehacer, comentarios, GoogleDrive, interconexión de Dropbox.

 1
Author: Romeno,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2015-11-18 09:55:06

Si está creando archivos .md para sus soluciones.NET, le recomiendo la extensión Visual Studio 2015 Markdown Editor ya que tiene un panel de vista previa para que pueda ver sus cambios en tiempo real.

EDITAR: Esto también debería funcionar ahora con Visual Studio 2017.

 1
Author: bytedev,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2017-09-07 10:38:24

Lo más fácil, si no tiene un lector, es abrir el archivo MD con un editor de texto y luego escribir el archivo MD como un archivo HTML y luego hacer doble clic para verlo con el navegador.

 0
Author: richardwendrock,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2013-10-29 18:16:01

El .md significa Markdown Text. Básicamente, es solo otro tipo de archivo de texto, como .txt

Uso Notepad++ para leer y editar estos

 0
Author: NocFenix,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2015-09-11 18:00:00