Markdown文件的文件扩展名?


116

独立的Markdown文件是否有官方文件扩展名?


8
有谁使用filename.md.txt的方式与之相同filename.rst.txt?它表示它是markdown格式,但是如果您没有处理markdown的内容,它也会退回到纯文本格式。GitHub可以识别.rst.txt,但不能识别.md.txtgist.github.com/2770487
endolith

1
如果您打算将这些文件存储在Windows计算机上,那么我会坚持使用<= 3个字符扩展名。这使得.md.mkd唯一的常用选项。其中.mdFAR更受欢迎,因此我强烈建议您使用它。不用担心机器描述符文件;它们没有被广泛使用,它们应该在Markdown编辑器中完美地进行编辑(只是忽略编辑器的预览部分)。
krowe2 2014年

Answers:


109

正如其他答案所解释的,不需要Markdown文件扩展名。但是,为了使编辑器或解析器确保使用的文件是Markdown格式的文件,他们将寻找以下扩展名之一:

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

诸如GitHub之类的网站仅使用这些扩展名中的一部分来转换为HTML,因此开发人员将符合其标准。(请参见下面的示例)

就个人而言,我已经看到.markdown.mdown最常用的,并且作为一个Linux用户我会避免使用.MD因为这也可以是 achine d编译代码与GCC ESCRIPTION文件。


扩展用法示例:

GitHubmarkdown,mdown,mkdn,mkd,md源码

Elements Markdown编辑器:markdown,mdown,mdwn,md

Vim markdownmarkdown,mdown,mkdn,mdwn,mkd,md

Bitbucketmarkdown,mdown,mkdn,mkd,md,text

R StudioRmd


进一步阅读

有一个降价的邮件列表有关于这个话题有趣的讨论:12

特别是揭示是其中的一种解释:

Markdown并不是要接管文件的格式,而是一种将信息巧妙地添加到纯文本中的方法。确实,Markdown的存在是元数据,而不是文件格式。
...
如果找到Markdown语法,没有人会打开一个文本文件,这是纯粹的好处。

从这个意义上讲,使用“ .text”,“。txt”或任何其他相关的纯文本扩展名是有意义的。
...
对Markdown一无所知的编辑器不会在乎元数据,也不会被各种“非标准”扩展所迷惑,但是会很好地显示和编辑纯文本。


到位桶使用MD,mkdn,降价:confluence.atlassian.com/display/BITBUCKET/...
兰迪Syring

此时,.md和.markdown似乎是最常用的扩展名。
克里斯托弗·巴伯

对GitHub上公认的扩展小更新,似乎名单长大一点:mdmkdmkdnmdwnmdownmarkdown-
罗伯特·奥迪

16

MarkDown和类似的轻量级标记的概念应作为纯文本可读,因此它们具有文本/纯文本扩展名(.txt.text)。

但是,有些人使用.markdown.mdown


2
仅作记录,iPhone的Elements即可识别.md,.markdown,.mdown,.mdwn和.text
Beat Rupp

4
vim 7.3可以识别.markdown和.mdown,因此.markdown是最具描述性的。
马丁·乌丁

1
Kohana使用.md
Liam Dawson

3
我也在GitHub上看到了几个.md,而我在办公室的Vim则将其识别为Markdown(我必须检查一下为什么它不在家)。
2011年

1
这个答案不如投票最多的人那么广泛/完整。
svandragt 2011年




1

简而言之,答案是否定的。

如果您只是将markdown文件用作不会以任何方式处理的独立文件,请随意命名。如果您在系统中使用它们,将它们处理为HTML或PDF或其他格式,则需要弄清楚系统要求Markdown文件使用哪些文件扩展名。

同样,在UNIX系统的上下文中,文件扩展名甚至不是必需的。您可以简单地拥有Markdown格式的名为“ README”的文件。


但是file只会告诉您它是ASCII文本,并不能告诉可以通过运行markdown
马丁·乌丁2011年

1

作为Cas很好的回答的补充,我想提一下,他到Vim markdown的github存储库的链接已被弃用。

用户plasticboy是Vim Markdown的原始创建者,但目前由 Hallison Batista和其他人开发并上传到vim脚本站点

例如,一个用户做了一个分叉来支持Gollum链接。


0

嗯... Geany,开源IDE,当保存Markdown格式的文件时,使用.mdml扩展名。奇怪的是,它似乎是唯一的一个。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.