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


116

Существует ли официальное расширение для автономных файлов 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, не будет заботиться о метаданных и не будет смущен множеством «нестандартных» расширений, но будет просто отображать и редактировать открытый текст.


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.


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означает простой текст, а не уценку.
эндолит



1

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

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

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


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

1

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

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

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


0

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

Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.