Ekstensi file untuk file Penurunan harga?

116

Apakah ada ekstensi file resmi untuk file Markdown mandiri?

Kocok Rupp
sumber
8
Adakah yang menggunakan filename.md.txtdengan cara yang sama filename.rst.txt? Ini menunjukkan bahwa itu adalah format penurunan harga, tetapi juga kembali ke teks biasa jika Anda tidak memiliki sesuatu untuk menangani penurunan harga. GitHub mengakui .rst.txt, tetapi tidak .md.txt: gist.github.com/2770487
endolith
1
Jika Anda berencana untuk menyimpan file-file ini pada mesin Windows maka saya akan tetap dengan ekstensi <= 3 karakter. Ini membuat .mddan .mkdsatu-satunya pilihan yang biasa digunakan. Dari mereka .mdJAUH lebih populer sehingga saya sangat menyarankan menggunakan itu Jangan khawatir tentang file deskriptor mesin; mereka tidak banyak digunakan dan mereka harus dapat diedit dengan sempurna di Editor Penurunan Harga (abaikan saja bagian pratinjau editor).
krowe2

Jawaban:

109

Tidak ada persyaratan untuk ekstensi file Penurunan harga, seperti jawaban lain telah menjelaskan. Tetapi agar editor atau parser menjamin bahwa file yang mereka gunakan diformat dengan Markdown, mereka akan mencari salah satu ekstensi berikut:

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

Ada situs web seperti GitHub yang hanya menggunakan pilihan ekstensi ini untuk mengonversi ke HTML sehingga pengembang akan memenuhi standar mereka. (lihat contoh di bawah)

Secara pribadi, saya telah terlihat .markdown dan .mdown yang paling digunakan, dan sebagai pengguna Linux saya akan menghindari menggunakan .md karena hal ini juga bisa menjadi m esin d berkas escription untuk mengkompilasi kode dengan GCC.


Contoh penggunaan ekstensi:

GitHub : markdown, mdown, mkdn, mkd, md ( sumber )

Editor Penurunan Nilai Elemen : penurunan harga, penurunan, mdwn, md

Penurunan harga Vim : penurunan harga, mdown, mkdn, mdwn, mkd, md

Bitbucket : markdown, mdown, mkdn, mkd, md, teks ( sumber )

R Studio : Rmd


Bacaan lebih lanjut

Ada milis Markdown yang memiliki diskusi menarik tentang topik ini: 1 , 2 .

Dan khususnya pengungkapan adalah salah satu penjelasannya:

Penurunan harga tidak dimaksudkan untuk mengambil alih format file, ini adalah cara untuk menambahkan informasi secara halus ke teks biasa. Sungguh, kehadiran penurunan harga adalah metadata, bukan format file.
...
Tidak ada yang membuka file teks akan bingung jika mereka menemukan sintaks Markdown, itu bonus murni.

Dalam pengertian ini, masuk akal untuk menggunakan ".text", ".txt", atau ekstensi plaintext lainnya yang relevan.
...
Editor yang tidak tahu apa-apa tentang Markdown tidak akan peduli dengan metadata dan tidak akan bingung dengan beragam ekstensi "non-standar", tetapi akan menampilkan dan mengedit plaintext dengan baik.

Cas
sumber
Bitbucket menggunakan md, mkdn, penurunan harga: confluence.atlassian.com/display/BITBUCKET/…
Randy Syring
.md dan .markdown tampaknya menjadi ekstensi yang paling umum digunakan pada saat ini.
Christopher Barber
Sedikit update pada ekstensi diakui oleh GitHub, tampaknya daftar tumbuh sedikit: md, mkd, mkdn, mdwn, mdown, markdown- sumber
Robert Audi
16

Ide MarkDown dan markup ringan lainnya harus dibaca sebagai teks biasa, sehingga memiliki teks / ekstensi polos ( .txtatau .text).

Namun, ada beberapa orang yang menggunakan .markdownatau .mdown.

vartec
sumber
2
Sebagai catatan saja, Elements untuk iPhone mengenali .md, .markdown, .mdown, .mdwn dan .text
Beat Rupp
4
vim 7.3 mengenali .markdown dan .mdown, jadi .markdown adalah yang paling deskriptif.
Martin Ueding
1
Kohana menggunakan .md
Liam Dawson
3
Saya telah melihat beberapa .md di GitHub juga, dan Vim saya di kantor mengenalinya sebagai Markdown (saya harus memeriksa mengapa tidak ada di rumah).
Wernight
1
Jawaban ini tidak seluas / selengkap yang memiliki suara terbanyak.
svandragt
3

Saya tidak menyadarinya, tapi saya pikir preseden ditetapkan dengan menggunakan .textekstensi di situs web resmi untuk mengungkap Markdown yang menghasilkan halaman.

Dennis Williamson
sumber
3
Hanya karena situs web resmi menggunakannya bukan berarti itu ide yang bagus. .textberarti teks biasa, bukan penurunan harga.
Endolith
2

iA Writer menggunakan ekstensi .md untuk konten penurunan harga.

Subhash Chandran
sumber
2

Doxygen menambahkan dukungan penurunan harga di v1.8. Itu mencari .mdatau .markdownmengajukan ekstensi.

Andy Dent
sumber
1

Singkatnya, jawabannya adalah tidak.

Jika Anda hanya menggunakan file penurunan harga sebagai file yang berdiri sendiri yang tidak akan diproses dengan cara apa pun, beri nama sesuka Anda. Jika Anda menggunakannya dalam suatu sistem yang memprosesnya menjadi HTML atau PDF atau format lain, maka Anda perlu mencari tahu ekstensi file apa yang diharapkan sistem untuk file penurunan harga.

Juga, dalam konteks sistem UNIX, ekstensi file bahkan tidak wajib. Anda cukup memiliki file yang disebut "README" dalam format penurunan harga.

Ryan Thompson
sumber
Tetapi filehanya akan memberi tahu Anda bahwa itu adalah teks ASCII, yang tidak memberi tahu saya bahwa saya dapat menjalankannya markdown.
Martin Ueding
1

Sebagai tambahan untuk jawaban yang sangat bagus dari Cas, saya ingin menyebutkan bahwa tautannya ke gudang github dari penurunan harga Vim agak usang.

Plasticboy pengguna adalah pencipta asli Vim Markdown tetapi saat ini dikembangkan dan diunggah ke situs skrip vim oleh Hallison Batista dan lainnya.

Misalnya satu pengguna melakukan garpu untuk mendukung tautan Gollum.

LeoR
sumber
0

Hmm ... Geany, IDE open source, saat menyimpan file berformat Markdown, menggunakan .mdmlekstensi. Aneh bahwa itu tampaknya menjadi satu-satunya ...

User203040
sumber