Question Extension de fichier pour les fichiers Markdown?


Existe-t-il une extension de fichier officielle pour les fichiers Markdown autonomes?


112
2018-02-23 16:23


origine


Est-ce que quelqu'un utilise filename.md.txt de la même façon que filename.rst.txt? Il indique qu'il est en format de démarcation, mais revient également au texte brut si vous n'avez rien à gérer. GitHub reconnaît .rst.txt, mais non .md.txt: gist.github.com/2770487 - endolith
Si vous prévoyez de stocker ces fichiers sur une machine Windows, je conserverai une extension de <= 3 caractères. Cela fait .md et .mkd les seules options couramment utilisées. De celles .md FAR est plus populaire, alors je suggère fortement de l'utiliser. Ne vous inquiétez pas des fichiers de descripteur de machine; ils ne sont pas très répandus et devraient être parfaitement modifiables dans un éditeur de Markdown (ignorez simplement la partie preview de l'éditeur). - krowe2


Réponses:


Il n'y a aucune exigence pour une extension de fichier Markdown, comme d'autres réponses l'ont expliqué. Mais pour que les éditeurs ou les analyseurs garantissent que le fichier qu'ils utilisent est au format Markdown, ils rechercheraient l'une des extensions suivantes:

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

Certains sites Web, tels que GitHub, utilisent uniquement une sélection de ces extensions pour la conversion au format HTML, ce qui permet aux développeurs de se conformer à leurs normes. (voir exemples ci-dessous)

Personnellement, j'ai vu .réduction et .mdown utilisé le plus, et en tant qu'utilisateur Linux, j'éviterais d'utiliser .Maryland comme cela peut aussi être un machine fichier de description pour la compilation de code avec GCC.


Exemples d'utilisation de l'extension:

GitHub: démarque, mdown, mkdn, mkd, md (la source)

Éléments Editeur de Markdown: markdown, mdown, mdwn, md

Vim markdown: démarque, mdown, mkdn, mdwn, mkd, md

Bitbucket: markdown, mdown, mkdn, mkd, md, texte (la source)

R Studio: Rmd


Lectures complémentaires

Il y a un Liste de diffusion Markdown cela a des discussions intéressantes sur ce sujet: 1, 2.

Et surtout révélatrice est l'une des explications:

Markdown n'est pas destiné à reprendre le format d'un fichier, c'est un moyen d'ajouter subtilement des informations au texte en clair. En réalité, la présence de Markdown est une métadonnée et non un format de fichier.
  ...
  Personne qui ouvre un fichier texte ne sera confus s'il trouve la syntaxe Markdown, c'est un pur bonus.

En ce sens, il est judicieux d'utiliser ".text", ".txt" ou toute autre extension de texte en clair.
  ...
  Un éditeur qui ne connaît rien à Markdown ne se souciera pas des métadonnées et ne sera pas dérouté par la diversité des extensions "non standard", mais affichera et éditera le texte en clair.


104
2018-05-19 18:38



Bitbucket utilise md, mkdn, markdown: confluence.atlassian.com/display/BITBUCKET/ - Randy Syring
.md et .markdown semblent être les extensions les plus couramment utilisées à ce stade. - Christopher Barber


L'idée de MarkDown et des marques de légèreté similaires est d'être lisible en texte brut, donc elles ont une extension texte / simple (.txt ou .text).

Cependant, il y a des gens qui utilisent .markdown ou .mdown.


16
2018-02-23 16:58



Juste pour mémoire, Elements for the iPhone reconnaît .md, .markdown, .mdown, .mdwn et .text - Beat Rupp
vim 7.3 reconnaît .markdown et .mdown, donc .markdown est le plus descriptif. - Martin Ueding
Kohana utilise .md - Liam Dawson
J'ai aussi vu quelques fichiers .md dans GitHub et mon Vim au bureau le reconnaît comme Markdown (je dois vérifier pourquoi il ne fonctionne pas chez moi). - Wernight
Cette réponse n'est pas aussi complète / complète que celle avec le plus de votes. - svandragt


Je ne suis pas au courant d'un, mais je pense qu'un précédent est établi par l'utilisation de la .text extension sur le site officiel à révéler le Markdown qui produit les pages.


3
2018-02-23 16:58



Ce n'est pas parce que le site Web officiel l'utilise que c'est une bonne idée. .text signifie texte brut, pas de démarque. - endolith


iA écrivain utilise l'extension .md pour le contenu Markdown.


2
2018-04-16 10:09





Doxygen Ajout du support Markdown dans la v1.8. Il recherche les extensions de fichier .md ou .markdown.


2
2018-05-18 05:28





Bref, la réponse est non.

Si vous utilisez simplement des fichiers de démarques en tant que fichiers autonomes qui ne seront en aucun cas traités, nommez-les comme bon vous semble. Si vous les utilisez dans un système, les traite au format HTML, PDF ou autre, vous devez alors déterminer les extensions de fichiers attendues par le système pour les fichiers de démarques.

De plus, dans le contexte d’un système UNIX, les extensions de fichier ne sont même pas obligatoires. Vous pourriez simplement avoir un fichier appelé "README" au format markdown.


1
2018-05-19 19:51



Mais file vous dira seulement que c'est du texte ASCII, qui ne dit pas moi que je peux le faire passer markdown. - Martin Ueding


En plus de la très bonne réponse de Cas, je voudrais mentionner que son lien au dépôt github de Vim markdown est quelque peu obsolète.

L'utilisateur plasticboy était le créateur original de Vim Markdown mais il est actuellement développé et téléchargé sur le site de scripts vim par Hallison Batista et d'autres.

Par exemple, un utilisateur a fait un fourchette soutenir Liens Gollum.


1
2017-12-28 14:17





Humm ... Geany, l'IDE open source, lors de l'enregistrement d'un fichier au format Markdown, utilise le .mdml extension. Étrange que cela semble être le seul ...


0
2018-03-01 15:51