Rozszerzenie pliku Markdown?

116

Czy istnieje oficjalne rozszerzenie plików dla samodzielnych plików Markdown?

Pokonaj Ruppa
źródło
8
Czy ktoś używa filename.md.txtw taki sam sposób jak filename.rst.txt? Wskazuje, że jest to format przecen, ale także wraca do zwykłego tekstu, jeśli nie masz czegoś do obsługi przecen. GitHub rozpoznaje .rst.txt, ale nie .md.txt: gist.github.com/2770487
endolit
1
Jeśli planujesz przechowywać te pliki na komputerze z systemem Windows, trzymam się rozszerzenia o długości <= 3 znaki. To sprawia .mdi .mkdjedyne często używane opcje. Spośród nich .mdFAR jest bardziej popularny, więc bardzo polecam to. Nie martw się o pliki deskryptorów maszyn; nie są one tak szeroko stosowane i powinny być w pełni edytowalne w Edytorze Markdown (po prostu zignoruj ​​część wstępną edytora).
krowe2

Odpowiedzi:

109

Jak już wyjaśniono w innych odpowiedziach, rozszerzenie pliku Markdown nie jest wymagane. Aby jednak redaktorzy lub analizatory składni zagwarantowali, że plik, którego używają, ma format Markdown, szukają jednego z następujących rozszerzeń:

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

Istnieją strony internetowe, takie jak GitHub, które używają tylko wybranych rozszerzeń do konwersji na HTML, aby programiści byli zgodni ze swoimi standardami. (patrz przykłady poniżej)

Osobiście widziałem .markdown i .mdown stosowane najbardziej, a jako użytkownik Linuksa Chciałbym unikać .md NumerKopiiZapasowej , gdyż może to być również m achine d plik PIS do kompilacji kodu z GCC.


Przykłady użycia rozszerzenia:

GitHub : markdown, mdown, mkdn, mkd, md ( źródło )

Elements Markdown Editor: markdown, mdown, mdwn, md

Vim markdown : markdown, mdown, mkdn, mdwn, mkd, md

Bitbucket : markdown, mdown, mkdn, mkd, md, text ( źródło )

R Studio : Rmd


Dalsza lektura

Istnieje lista mailingowa Markdown, która zawiera ciekawe dyskusje na ten temat: 1 , 2 .

Szczególnie odkrywcze jest jedno z wyjaśnień:

Markdown nie ma na celu przejęcia formatu pliku, jest to sposób subtelnego dodawania informacji do zwykłego tekstu. Naprawdę obecność Markdown to metadane, a nie format pliku.
...
Nikt otwierający plik tekstowy nie będzie zdezorientowany, jeśli znajdzie składnię Markdown, to czysty bonus.

W tym sensie sensowne jest użycie „.text”, „.txt” lub dowolnego innego rozszerzenia tekstu jawnego.
...
Edytor, który nic nie wie o Markdown, nie będzie dbał o metadane i nie będzie zdezorientowany różnorodnością „niestandardowych” rozszerzeń, ale dobrze wyświetli i zredaguje zwykły tekst.

Cas
źródło
Bitbucket używa md, mkdn, markdown: confluence.atlassian.com/display/BITBUCKET/…
Randy Syring
.md i .markdown wydają się być najczęstszymi rozszerzeniami używanymi w tym momencie.
Christopher Barber
Mała aktualizacja rozszerzeń uznanych przez GitHub, wydaje się, że lista rosła nieco: md, mkd, mkdn, mdwn, mdown, markdown- źródło
Robert Audi
16

Idea MarkDown i podobnych lekkich znaczników powinna być czytelna jako zwykły tekst, dlatego mają one rozszerzenie tekst / zwykły ( .txtlub .text).

Są jednak ludzie, którzy używają .markdownlub .mdown.

vartec
źródło
2
Dla przypomnienia, Elements for iPhone rozpoznaje .md, .markdown, .mdown, .mdwn i .text
Beat Rupp
4
vim 7.3 rozpoznaje .markdown i .mdown, więc .markdown jest najbardziej opisowy.
Martin Ueding
1
Kohana używa .md
Liam Dawson
3
Widziałem też kilka .md w GitHub, a mój Vim w biurze rozpoznaje go jako Markdown (muszę sprawdzić, dlaczego nie ma go w domu).
Wernight
1
Ta odpowiedź nie jest tak obszerna / kompletna jak ta z największą liczbą głosów.
svandragt
3

Nie jestem świadom jednego, ale myślę, że precedens jest ustawiony przez korzystanie z .textrozszerzeniem na oficjalnej stronie internetowej , aby odsłonić Markdown że produkuje stron.

Dennis Williamson
źródło
3
To, że korzysta z oficjalnej strony internetowej, nie oznacza, że ​​to dobry pomysł. .textoznacza zwykły tekst, a nie przecenę.
endolith
2

iA Writer używa rozszerzenia .md dla zawartości Markdown.

Subhash Chandran
źródło
2

Doxygen dodał obsługę Markdown w wersji 1.8. Szuka .mdlub .markdownrozszerzeń plików.

Andy Dent
źródło
1

Krótko mówiąc, odpowiedź brzmi „nie”.

Jeśli używasz plików przecen jako samodzielnych plików, które nie będą przetwarzane w żaden sposób, nazwij je, jak chcesz. Jeśli używasz ich w systemie, przetwarza je na HTML, PDF lub inny format, musisz dowiedzieć się, jakie rozszerzenia plików oczekuje system na pliki przeceny.

Ponadto w kontekście systemu UNIX rozszerzenia plików nie są nawet obowiązkowe. Możesz po prostu mieć plik o nazwie „README” w formacie przeceny.

Ryan Thompson
źródło
Ale filepowiem ci tylko, że jest to tekst ASCII, który nie mówi mi, że mogę go uruchomić markdown.
Martin Ueding
1

Jako dodatek do bardzo dobrej odpowiedzi Cas chciałbym wspomnieć, że jego link do repozytorium githubów na obniżce Vima jest nieco przestarzały.

Użytkownik plasticboy był oryginalnym twórcą Vim Markdown, ale jest on obecnie rozwijany i przesyłany na stronę skryptów vim przez Hallison Batista i innych.

Na przykład jeden użytkownik zrobił widelec, aby obsłużyć linki Gollum.

LeoR
źródło
0

Hmm ... Geany, IDE typu open source, podczas zapisywania pliku sformatowanego Markdown korzysta z .mdmlrozszerzenia. Dziwne, że wydaje się być jedynym ...

Użytkownik203040
źródło