Estensione file per file Markdown?


116

Esiste un'estensione di file ufficiale per i file Markdown autonomi?


8
Qualcuno usa filename.md.txtallo stesso modo di filename.rst.txt? Indica che è il formato markdown, ma ricade anche nel testo normale se non hai qualcosa per gestire il markdown. GitHub riconosce .rst.txt, ma non .md.txt: gist.github.com/2770487
endolith

1
Se hai intenzione di archiviare questi file su un computer Windows, mi atterrerei con un'estensione di carattere <= 3. Questo rende .mde .mkdle uniche opzioni comunemente usate. Di questi .mdè molto più popolare, quindi consiglio vivamente di usarlo. Non preoccuparti dei file descrittori della macchina; non sono molto usati e dovrebbero essere perfettamente modificabili in un Markdown Editor (basta ignorare la parte di anteprima dell'editor).
krowe2,

Risposte:


109

Non è necessario per un'estensione del file Markdown, come hanno spiegato altre risposte. Ma affinché editor o parser possano garantire che il file che stanno utilizzando sia formattato con Markdown, dovrebbero cercare una delle seguenti estensioni:

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

Esistono siti Web come GitHub che utilizzano solo una selezione di queste estensioni per la conversione in HTML, in modo che gli sviluppatori si adeguino al loro standard. (vedi esempi sotto)

Personalmente, ho visto .markdown e .mdown utilizzato di più, e come un utente Linux Vorrei evitare di usare .md come questo può anche essere un m achine d file di escription per la compilazione di codice con GCC.


Esempi di utilizzo dell'estensione:

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

Elements Markdown Editor: markdown, mdown, mdwn, md

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

Bitbucket : markdown, mdown, mkdn, mkd, md, text ( fonte )

R Studio : Rmd


Ulteriori letture

C'è una mailing list di Markdown che ha interessanti discussioni su questo argomento: 1 , 2 .

E soprattutto rivelare è una delle spiegazioni:

Markdown non ha lo scopo di assumere il formato di un file, è un modo per aggiungere sottilmente informazioni al testo in chiaro. In realtà, la presenza di Markdown è metadata, non un formato di file.
...
Nessuno aprendo un file di testo sarà confuso se trovano la sintassi di Markdown, è puro bonus.

In questo senso, ha senso usare ".text", ".txt" o qualunque altra estensione in chiaro sia rilevante.
...
Un editor che non sa nulla di Markdown non si preoccuperà dei metadati e non sarà confuso dalla varietà di estensioni "non standard", ma mostrerà e modificherà il testo in chiaro.



.md e .markdown sembrano essere le estensioni più comuni in uso a questo punto.
Christopher Barber,

Piccolo aggiornamento sulle estensioni riconosciute da GitHub, sembra che la lista è cresciuto un po ': md, mkd, mkdn, mdwn, mdown, markdown- fonte
Robert Audi

16

L'idea di MarkDown e di marcature leggere simili deve essere leggibile come testo semplice, quindi hanno estensione testo / semplice ( .txto .text).

Tuttavia, ci sono alcune persone che usano .markdowno .mdown.


2
Solo per la cronaca, Elements per iPhone riconosce .md, .markdown, .mdown, .mdwn e .text
Beat Rupp,

4
vim 7.3 riconosce .markdown e .mdown, quindi .markdown è il più descrittivo.
Martin Ueding,

1
Kohana usa .md
Liam Dawson il

3
Ho visto un paio di .md anche in GitHub e il mio Vim in ufficio lo riconosce come Markdown (devo controllare perché non lo fa a casa).
Wernight,

1
Questa risposta non è completa / completa come quella con il maggior numero di voti.
svandragt,




1

In breve, la risposta è no.

Se stai semplicemente utilizzando i file markdown come file autonomi che non verranno elaborati in alcun modo, chiamali come preferisci. Se li stai usando in un sistema, li elabora in HTML o PDF o in qualche altro formato, quindi devi capire quali estensioni di file il sistema si aspetta per i file di markdown.

Inoltre, nel contesto di un sistema UNIX, le estensioni dei file non sono nemmeno obbligatorie. Si potrebbe semplicemente avere un file chiamato "README" in formato markdown.


Ma filesolo vi dirà che si tratta di testo ASCII, che non dice di me che posso eseguirlo tramite markdown.
Martin Ueding,

1

Come aggiunta all'ottima risposta di Cas, vorrei ricordare che il suo collegamento al repository github del markdown di Vim è in qualche modo deprecato.

L'utente plasticboy era il creatore originale di Vim Markdown ma attualmente è sviluppato e caricato sul sito degli script vim da Hallison Batista e altri.

Ad esempio, un utente ha fatto un fork per supportare i collegamenti Gollum.


0

Hmm ... Geany, l'IDE open source, quando si salva un file formattato Markdown, usa l' .mdmlestensione. Strano che sembra essere l'unico ...

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.