Questão Extensão de arquivo para arquivos Markdown?


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


112


origem


Alguém usa filename.md.txt Da mesma maneira que filename.rst.txt? Isso indica que é um formato de marcação, mas também retorna para texto simples, se você não tiver algo para manipular a marcação. O GitHub reconhece .rst.txt, mas não .md.txt: gist.github.com/2770487 - endolith
Se você planeja armazenar esses arquivos em uma máquina Windows, eu ficaria com uma extensão de <= 3 caracteres. Isto faz .md e .mkd as únicas opções comumente usadas. Daqueles .md é muito mais popular, então eu sugiro usar isso. Não se preocupe com arquivos descritores de máquina; eles não são muito usados ​​e devem ser perfeitamente editáveis ​​em um editor de Markdown (apenas ignore a parte de visualização do editor). - krowe2


Respostas:


Não há necessidade de uma extensão de arquivo Markdown, como outras respostas explicaram. Mas para que editores ou analisadores garantam que o arquivo que estão usando é formatado com 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 usado mais, e como um usuário Linux eu evitaria usar .md como isso também pode ser um machine dArquivo escription para compilar código com o GCC.


Exemplos de uso de extensão:

GitHub: remarcação, mdown, mkdn, mkd, md (fonte)

Elementos Markdown Editor: remarcação, mdown, mdwn, md

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

Bitbucket: remarcação, mdown, mkdn, mkd, md, texto (fonte)

Estúdio R: Rmd


Leitura Adicional

Existe um Lista de discussão de Markdown que tem discussões interessantes sobre esse tópico: 1, 2.

E especialmente revelador é uma das explicações:

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

Nesse sentido, faz sentido usar ".text", ".txt" ou qualquer outra extensão de texto simples que seja relevante.
  ...
  Um editor que não sabe nada sobre o Markdown não se importará com os metadados e não ficará confuso com a variedade de extensões "não padrão", mas exibirá e editará o texto sem formatação bem.


104



Bitbucket usa md, mkdn, markdown: confluence.atlassian.com/display/BITBUCKET/… - Randy Syring
.md e .markdown parecem ser as extensões mais comuns em uso neste momento. - Christopher Barber


A ideia do MarkDown e de marcações de peso semelhantes semelhantes é legível como texto simples, assim eles têm extensão text / plain (.txt ou .text).

No entanto, existem algumas pessoas que usam .markdown ou .mdown.


16



Apenas para registro, o Elements for the iPhone reconhece .md, .markdown, .mdd, .mdwn e .text - Beat Rupp
O vim 7.3 reconhece .markdown e .mdown, então .markdown é o mais descritivo. - Martin Ueding
Kohana usa .md - Liam Dawson
Eu vi um par de .md no GitHub também, e meu Vim no escritório o reconhece como Markdown (eu tenho que checar porque não funciona em casa). - Wernight
Esta resposta não é tão extensa / completa quanto a que tem mais votos. - svandragt


Eu não estou ciente de um, mas acho que um precedente é definido pelo uso do .text extensão no website oficial para revelar o Markdown que produz as páginas.


3



Só porque o site oficial usa isso não significa que é uma boa idéia, no entanto. .text significa texto simples, não markdown. - endolith


iA Writer usa a extensão .md para o conteúdo Markdown.


2





Doxygen adicionou o Markdown suppport na v1.8. Ele procura por extensões de arquivo .md ou .markdown.


2





Em suma, a resposta é não.

Se você estiver simplesmente usando arquivos markdown como arquivos independentes 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ê precisa descobrir quais extensões de arquivos o sistema espera para arquivos de remarcação.

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


1



Mas file só vai te dizer que é texto ASCII, que não diz mim que eu posso executá-lo através markdown. - Martin Ueding


Como complemento à resposta muito boa de Cas, gostaria de mencionar que o link dele para o repositório do github do markdown do Vim é um pouco obsoleto.

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

Por exemplo, um usuário fez um garfo suportar Links Gollum.


1





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


0