Расширение файла для файлов Markdown?

116

Существует ли официальное расширение для автономных файлов Markdown?

file-extension markdown Бить Рупп
источник
8
Кто-нибудь использует так filename.md.txtже, как filename.rst.txt? Это указывает на то, что это формат уценки, но также возвращается к простому тексту, если у вас нет чего-то для обработки уценки. GitHub признает .rst.txt, но не .md.txt: gist.github.com/2770487
эндолиты
1
Если вы планируете хранить эти файлы на компьютере с Windows, то я буду использовать расширение <= 3 символа. Это делает .mdи .mkdединственными часто используемыми вариантами. Из них .mdFAR более популярен, поэтому я настоятельно рекомендую использовать это. Не беспокойтесь о файлах дескрипторов машин; они не так широко используются, и они должны быть полностью редактируемыми в редакторе уценок (просто игнорируйте часть предварительного просмотра редактора).
krowe2

Ответы:

109

Как указано в других ответах, расширение файла Markdown не требуется. Но для того, чтобы редакторы или парсеры могли гарантировать, что используемый ими файл имеет формат Markdown, они должны искать одно из следующих расширений:

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

Существуют такие сайты, как GitHub, которые используют только некоторые из этих расширений для преобразования в HTML, поэтому разработчики будут соответствовать их стандарту. (см. примеры ниже)

Лично я видел .markdown и .mdown использовали больше всего, и как пользователь Linux , я бы не использовать .md как это также может быть м achine d ПИСАНИЕ файл для компиляции кода с GCC.

Примеры использования расширения:

GitHub : уценка, mdown, mkdn, mkd, md ( источник )

Редактор элементов Markdown: уценка, mdown, mdwn, md

Vim уценка : уценка, mdown, mkdn, mdwn, mkd, md

Bitbucket : уценка, mdown, mkdn, mkd, md, текст ( источник )

R Studio : Rmd

Дальнейшее чтение

Существует список рассылки Markdown , в котором обсуждаются интересные темы: 1 , 2 .

И особенно показательным является одно из объяснений:

Markdown не предназначен для принятия формата файла, это способ тонкого добавления информации в открытый текст. Действительно, наличие Markdown - это метаданные, а не формат файла.
...
Никто, открывающий текстовый файл, не будет сбит с толку, если найдет синтаксис Markdown, это чистый бонус.

В этом смысле имеет смысл использовать «.text», «.txt» или любое другое расширение открытого текста.
...
Редактор, который ничего не знает о Markdown, не будет заботиться о метаданных и не будет смущен множеством «нестандартных» расширений, но будет просто отображать и редактировать открытый текст.

Cas
источник
Bitbucket использует md, mkdn, markdown: confluence.atlassian.com/display/BITBUCKET/…
Randy Syring
.md и .markdown являются наиболее распространенными расширениями, используемыми на данный момент.
Кристофер Барбер
Небольшое обновление на продолжениях признаваемых GitHub, кажется , список вырос немного: md, mkd, mkdn, mdwn, mdown, markdown- источник
Роберт Audi
16

Идея MarkDown и подобных облегченных разметок состоит в том, чтобы их можно было читать как обычный текст, поэтому они имеют расширение text / plain ( .txtили .text).

Тем не менее, есть некоторые люди, которые используют .markdownили .mdown.

Vartec
источник
2
Просто для записи, Elements для iPhone распознает .md, .markdown, .mdown, .mdwn и .text
Beat Rupp
4
vim 7.3 распознает .markdown и .mdown, поэтому .markdown является наиболее описательным.
Мартин Уединг
1
Кохана использует .md
Лиам Доусон
3
Я также видел пару .md в GitHub, и мой Vim в офисе распознает его как Markdown (я должен проверить, почему его нет дома).
Wernight
1
Этот ответ не такой обширный / полный, как тот, который набрал наибольшее количество голосов.
svandragt
3

Я не знаю ни одного, но я думаю, что прецедент установлен использованием .textрасширения на официальном сайте, чтобы показать уценку, которая производит страницы.

Деннис Уильямсон
источник
3
То, что он используется на официальном сайте, не означает, что это хорошая идея. .textозначает простой текст, а не уценку.
эндолит
2

iA Writer использует расширение .md для содержимого Markdown.

Субхаш Чандран
источник
2

Doxygen добавил поддержку Markdown в версии 1.8. Ищет .mdили .markdownрасширение файла.

Энди Дент
источник
1

Короче, ответ - нет.

Если вы просто используете файлы разметки в качестве автономных файлов, которые не будут обрабатываться каким-либо образом, назовите их по своему усмотрению. Если вы используете их в системе, обрабатывает их в HTML, PDF или в каком-либо другом формате, вам необходимо выяснить, какие расширения файлов ожидает система для файлов уценки.

Кроме того, в контексте системы UNIX расширения файлов даже не являются обязательными. Вы могли бы просто иметь файл с именем «README» в формате уценки.

Райан Томпсон
источник
Но fileтолько скажу вам, что это текст ASCII, который не говорит мне, что я могу пройти через него markdown.
Мартин Юдинг
1

В дополнение к очень хорошему ответу Кас я хотел бы упомянуть, что его ссылка на github-репозиторий Vim markdown несколько устарела.

Plasticboy пользователь был оригинальным создателем Vim Markdown , но в настоящее время разработаны и загружены на сайте VIM сценариев по Hallison Батисты и другие.

Например, один пользователь сделал форк для поддержки ссылок Gollum.

Леор
источник
0

Хм ... Geany, IDE с открытым исходным кодом, при сохранении файла в формате Markdown использует .mdmlрасширение. Странно, что это, кажется, единственный ...

User203040
источник