Существует ли официальное расширение для автономных файлов Markdown?
8 ответов
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, не будет заботиться о метаданных и не будет смущен разнообразием «нестандартных» расширений, но будет просто отображать и редактировать открытый текст.
16
Идея MarkDown и подобных облегченных разметок заключается в том, чтобы их можно было читать как обычный текст, поэтому они имеют расширение text/plain (.txt или .text).
Однако есть некоторые люди, которые используют .markdown или .mdown .
3
Я не знаю ни одного, но я думаю, что прецедент установлен использованием расширения .text на официальном сайте, чтобы показать уценку, которая производит страницы.
2
iA Writer использует расширение .md для содержимого Markdown.
2
Doxygen добавил поддержку Markdown в версии 1.8. Он ищет расширения файлов .md или .markdown .
1
В дополнение к очень хорошему ответу Кас я хотел бы упомянуть, что его ссылка на github-репозиторий Vim markdown несколько устарела.
Пользователь plasticboy был первоначальным создателем Vim Markdown, но в настоящее время он разработан и загружен на сайт сценариев vim Хэллисоном Батистой и другими.
Например, один пользователь сделал форк для поддержки ссылок Gollum.
1
Короче говоря, ответ - нет.
Если вы просто используете файлы разметки в качестве автономных файлов, которые не будут обрабатываться каким-либо образом, назовите их по своему усмотрению. Если вы используете их в системе, обрабатывает их в HTML, PDF или в каком-либо другом формате, вам необходимо выяснить, какие расширения файлов ожидает система для файлов уценки.
Кроме того, в контексте системы UNIX расширения файлов даже не являются обязательными. Вы могли бы просто иметь файл с именем "README" в формате уценки.
0
Хм ... Geany, IDE с открытым исходным кодом, при сохранении файла в формате Markdown использует расширение .mdml . Странно, что это, кажется, единственный ...