Extensão de arquivo para arquivos Markdown?


116

Existe uma extensão de arquivo oficial para arquivos autônomos do Markdown?


8
Alguém usa filename.md.txtda mesma maneira que filename.rst.txt? Indica que é formato de remarcação, mas também volta ao texto sem formatação se você não tiver algo para lidar com remarcação. GitHub reconhece .rst.txt, mas não .md.txt: gist.github.com/2770487
endolith

1
Se você planeja armazenar esses arquivos em uma máquina Windows, eu usaria uma extensão de caractere <= 3. Isso faz .mde .mkdas únicas opções comumente usadas. Destes .mdé muito mais popular, então eu sugiro usar isso. Não se preocupe com os arquivos do descritor da máquina; eles não são tão amplamente usados ​​e devem ser perfeitamente editáveis ​​em um editor de Markdown (apenas ignore a parte de visualização do editor).
krowe2

Respostas:


109

Não há requisitos para uma extensão de arquivo Markdown, como outras respostas explicaram. Mas, para que editores ou analisadores garantam que o arquivo que eles estão usando tenha o formato Markdown, eles procurariam uma das seguintes extensões:

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

Existem sites como o GitHub que usam apenas uma seleção dessas extensões para converter em HTML, para que os desenvolvedores estejam em conformidade com seus padrões. (veja exemplos abaixo)

Pessoalmente, tenho visto .markdown e .mdown o mais utilizado, e como um usuário Linux gostaria de evitar usando Md pois isso também pode ser uma m achine d arquivo escrição para compilar o código com o GCC.


Exemplos de uso de extensão:

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

Editor de Markdown de elementos : markdown, mdown, mdwn, md

Remarcação Vim : remarcação, mdown, mkdn, mdwn, mkd, md

Bitbucket : markdown, mdown, mkdn, mkd, md, texto ( origem )

R Estúdio : Rmd


Leitura adicional

Há uma lista de discussão do Markdown que tem discussões interessantes sobre esse tópico: 1 , 2 .

E especialmente revelador é uma das explicações:

O markdown não deve assumir o formato de um arquivo, é uma maneira de adicionar sutilmente informações ao texto sem formatação. Realmente, a presença do Markdown é metadados, não um formato de arquivo.
...
Ninguém abrindo um arquivo de texto ficará confuso se encontrar a sintaxe do Markdown, é um bônus puro.

Nesse sentido, faz sentido usar ".text", ".txt" ou qualquer outra extensão de texto sem formatação relevante.
...
Um editor que não sabe nada sobre o Markdown não se importa com os metadados e não se confunde com a variedade de extensões "não-padrão", mas exibe e edita o texto sem formatação.


Bitbucket usa md, mkdn, remarcação: confluence.atlassian.com/display/BITBUCKET/...
Randy Syring

.md e .markdown parecem ser as extensões mais comuns em uso neste momento.
Christopher Barber

Pouco atualização sobre as extensões reconhecidas pelo GitHub, parece que a lista cresceu um pouco: md, mkd, mkdn, mdwn, mdown, markdown- fonte
Robert Audi

16

A idéia de MarkDown e marcações leves semelhantes deve ser legível como texto sem formatação, portanto elas têm extensão de texto / sem formatação ( .txtou .text).

No entanto, existem algumas pessoas que usam .markdownou .mdown.


2
Apenas para o registro, Elementos para o iPhone reconhece Md, .markdown, .mdown, .mdwn e .text
Bata Rupp

4
O vim 7.3 reconhece .markdown e .mdown, portanto, .markdown é o mais descritivo.
Martin Ueding

1
O Kohana usa .md
Liam Dawson

3
Também já vi alguns .md no GitHub, e meu Vim no escritório o reconhece como Markdown (tenho que verificar por que não acontece em casa).
Wernight 27/07/11

1
Esta resposta não é tão extensa / completa quanto a que tem mais votos.
svandragt




1

Em suma, a resposta é não.

Se você estiver simplesmente usando arquivos de remarcação como arquivos autônomos que não serão processados ​​de forma alguma, nomeie-os como desejar. Se você os estiver usando em um sistema, os processará em HTML ou PDF ou algum outro formato, então você precisará descobrir quais extensões de arquivo esse sistema espera para arquivos de remarcação.

Além disso, no contexto de um sistema UNIX, as extensões de arquivo nem são obrigatórias. Você pode simplesmente ter um arquivo chamado "README" no formato de remarcação.


Mas filesó vou lhe dizer que é texto ASCII, o que não me diz que eu possa executá-lo markdown.
Martin Ueding

1

Como complemento à resposta muito boa de Cas, eu gostaria de mencionar que o link para o repositório github da marcação Vim está um pouco obsoleto.

O usuário plasticboy foi o criador original do Vim Markdown, mas atualmente é desenvolvido e carregado no site de scripts do vim por Hallison Batista e outros.

Por exemplo, um usuário fez uma bifurcação para dar suporte aos links Gollum.


0

Hmm ... Geany, o IDE de código aberto, ao salvar um arquivo formatado Markdown, usa a .mdmlextensão. Estranho que pareça ser o único ...

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.