Extensión de archivo para archivos Markdown?

116

¿Existe una extensión de archivo oficial para los archivos de Markdown independientes?

Beat Rupp
fuente
8
¿Alguien usa filename.md.txtde la misma manera que filename.rst.txt? Indica que es un formato de rebaja, pero también recurre a texto sin formato si no tiene algo para manejar la rebaja. GitHub reconoce .rst.txt, pero no .md.txt: gist.github.com/2770487
endolith
1
Si planea almacenar estos archivos en una máquina con Windows, me quedaría con una extensión <= 3 caracteres. Esto hace .mdy .mkdlas únicas opciones de uso común. De ellos .mdes MUCHO más popular, así que sugiero usar eso. No se preocupe por los archivos descriptores de la máquina; no son tan utilizados y deberían ser perfectamente editables en un Editor Markdown (simplemente ignore la parte de vista previa del editor).
krowe2

Respuestas:

109

No hay requisitos para una extensión de archivo Markdown, como han explicado otras respuestas. Pero para que los editores o analizadores garanticen que el archivo que están usando tiene formato Markdown, buscarían una de las siguientes extensiones:

.markdown
.mdown
.mkdn
.md
.mkd
.mdwn
.mdtxt
.mdtext
.text
.Rmd

Hay sitios web como GitHub que solo usan una selección de estas extensiones para convertir a HTML para que los desarrolladores se ajusten a su estándar. (ver ejemplos a continuación)

En lo personal, he visto .markdown y .mdown utilizado la mayor parte, y como usuario de Linux que evitaría el uso de .md ya que esto también puede ser una m áquina d archivo escripción para compilar código con GCC.


Ejemplos de uso de extensiones:

GitHub : markdown, mdown, mkdn, mkd, md ( fuente )

Elementos Markdown Editor: markdown, mdown, mdwn, md

Vim markdown : markdown, mdown, mkdn, mdwn, mkd, md

Bitbucket : markdown, mdown, mkdn, mkd, md, texto ( fuente )

Estudio R : Rmd


Otras lecturas

Hay una lista de correo de Markdown que tiene discusiones interesantes sobre este tema: 1 , 2 .

Y especialmente revelador es una de las explicaciones:

Markdown no está destinado a asumir el formato de un archivo, es una forma de agregar información sutilmente al texto sin formato. Realmente, la presencia de Markdown es metadatos, no un formato de archivo.
...
Nadie que abra un archivo de texto se confundirá si encuentra la sintaxis de Markdown, es pura ventaja.

En este sentido, tiene sentido usar ".text", ".txt", o cualquier otra extensión de texto sin formato que sea relevante.
...
Un editor que no sabe nada sobre Markdown no se preocupará por los metadatos y no se confundirá con la variedad de extensiones "no estándar", pero mostrará y editará el texto sin formato muy bien.

Cas
fuente
Bitbucket usa md, mkdn, markdown: confluence.atlassian.com/display/BITBUCKET/…
Randy Syring el
.md y .markdown parecen ser las extensiones más comunes en uso en este momento.
Christopher Barber
Poco actualización de las extensiones reconocidas por GitHub, parece que la lista creció un poco: md, mkd, mkdn, mdwn, mdown, markdown- fuente
Robert Audi
16

La idea de MarkDown y marcas de peso ligero similares es ser legible como texto sin formato, por lo que tienen extensión de texto / sin formato ( .txto .text).

Sin embargo, hay algunas personas que usan .markdowno .mdown.

vartec
fuente
2
Solo para el registro, Elements para el iPhone reconoce .md, .markdown, .mdown, .mdwn y .text
Beat Rupp
44
vim 7.3 reconoce .markdown y .mdown, por lo que .markdown es el más descriptivo.
Martin Ueding
1
Kohana usa .md
Liam Dawson
3
También he visto un par de .md en GitHub, y mi Vim en la oficina lo reconoce como Markdown (tengo que comprobar por qué no lo hace en casa).
Wernight
1
Esta respuesta no es tan extensa / completa como la que tiene más votos.
svandragt
3

No conozco ninguno, pero creo que se establece un precedente mediante el uso de la .textextensión en el sitio web oficial para revelar el Markdown que produce las páginas.

Dennis Williamson
fuente
3
Sin embargo, solo porque el sitio web oficial lo use no significa que sea una buena idea. .textsignifica texto sin formato, no rebajas.
Endolito
2

iA Writer usa la extensión .md para el contenido de Markdown.

Subhash Chandran
fuente
2

Doxygen agregó soporte de Markdown en v1.8. Busca .mdo .markdownextensiones de archivo.

Andy Dent
fuente
1

En resumen, la respuesta es no.

Si simplemente está utilizando archivos de descuento como archivos independientes que no se procesarán de ninguna manera, asígneles el nombre que desee. Si los está utilizando en un sistema que los procesa en HTML o PDF o en algún otro formato, entonces necesita averiguar qué extensiones de archivo espera ese sistema para los archivos de rebajas.

Además, en el contexto de un sistema UNIX, las extensiones de archivo ni siquiera son obligatorias. Simplemente podría tener un archivo llamado "README" en formato de descuento.

Ryan Thompson
fuente
Pero filesólo le dirá que se trata de texto ASCII, lo que no le dice a que puedo ejecutar a través markdown.
Martin Ueding
1

Como una adición a la muy buena respuesta de Cas, me gustaría mencionar que su enlace al repositorio github de Vim Markdown es algo obsoleto.

El usuario plasticboy fue el creador original de Vim Markdown, pero actualmente es desarrollado y subido al sitio de scripts de vim por Hallison Batista y otros.

Por ejemplo, un usuario hizo una bifurcación para admitir enlaces Gollum.

LeoR
fuente
0

Hmm ... Geany, el IDE de código abierto, cuando guarda un archivo con formato Markdown, usa la .mdmlextensión. Es extraño que parezca ser el único ...

Usuario203040
fuente