Um arquivo .md não é um formato obscuro de desenvolvedor. Por baixo, é texto comum. Qualquer editor básico pode lê-lo, enquanto alguns símbolos simples transformam linhas em títulos, listas, links e ênfase.
Markdown em inglês simples
Markdown é uma maneira de estruturar a escrita sem sair do teclado. Coloque dois sinais de hash antes de uma linha e ela se torna um subtítulo. Coloque uma frase entre dois asteriscos e ela se torna em negrito. A fonte continua legível mesmo em um aplicativo que não sabe nada sobre Markdown.
A extensão .md diz ao Android e aos editores de texto como interpretar esses símbolos. Você também pode ver .markdown; ele representa o mesmo tipo de documento.
| Você quer | Você digita | Você obtém |
|---|---|---|
| Um título | ## Plano de viagem | Um título de segundo nível |
| Texto em negrito | **importante** | importante |
| Texto em itálico | *aside* | lado |
| Um link | [Loknot](https://loknot.app) | Um link com rótulo |
| Um item de lista | - reservar os ingressos | Uma lista com marcadores |
| Uma tarefa | - [ ] ligar para o Alex | Uma tarefa não marcada |
| Texto monoespaçado | `nome_arquivo` | Código ou um nome exato |
Muitos editores usam dois tis para riscado: ~~done~~. É uma extensão comum,
ao invés do núcleo mais básico do Markdown. O sublinhado geralmente é deixado de fora completamente porque um
sublinhado na web convencionalmente significa um link. Se você precisar dele, verifique o editor específico.
Como abrir um arquivo .md em um telefone Android
O Android pode não escolher um aplicativo adequado automaticamente. Após baixar o arquivo, abra o menu “Abrir com” do sistema e escolha um editor que suporte Markdown. Se aparecer apenas um navegador ou gerenciador de arquivos, instale um editor Markdown ou use o comando Importar dentro do seu aplicativo de notas.
Loknot abre tanto .md quanto .markdown. Você pode continuar editando o código-fonte,
então mudar para Visualização para ver títulos formatados, links clicáveis, tabelas e tarefas.
Como criar um arquivo Markdown no Android
Comece com uma nota comum
Escreva normalmente. Você não precisa marcar todos os parágrafos; cabeçalhos e listas já são suficientes para tornar o Markdown útil.
Adicione a estrutura que você precisa
Use hashes para cabeçalhos, hífens para listas e colchetes para tarefas. O Loknot também coloca marcas comuns em sua barra de formatação.
Verificar visualização
Observe linhas em branco, listas aninhadas, links e tabelas antes de entregar o documento para outro aplicativo.
Exportar como .md
Escolha Markdown no menu de Exportar. O resultado é um arquivo de texto independente que você pode salvar ou enviar.
Abrir o arquivo em outro lugar
Vale a pena fazer um teste rápido antes de enviá-lo para um editor ou mover uma biblioteca inteira.
Como compartilhar um arquivo Markdown
Anexe o arquivo .md a um e-mail, envie-o como um documento em um mensageiro, salve-o no Google Drive ou transfira-o por cabo. Enviar o arquivo geralmente é mais seguro do que colar seu conteúdo em um campo de mensagem, onde um serviço pode alterar quebras de linha ou interpretar asteriscos como sua própria formatação.
Se o destinatário só precisa ler o documento, inclua uma cópia em HTML. Ele abre em um navegador e mostra a formatação final. Se ele for editar a fonte, o arquivo .md é suficiente.
Por que o Markdown envelhece bem
Formatos proprietários são agradáveis enquanto você permanece em um único aplicativo. O Markdown escolhe a portabilidade em vez disso. Anos depois, o arquivo ainda pode ser aberto como texto, pesquisado e convertido em outra coisa.
- Ele abre no Android, Windows, macOS e Linux.
- A pesquisa em texto completo não requer um banco de dados especial.
- Editores, geradores de sites e sistemas de conhecimento entendem isso.
- Ele se encaixa naturalmente no controle de versão.
- Suas palavras não desaparecem com um único aplicativo.
Onde a compatibilidade fica complicada
O Markdown possui um núcleo amplamente compreendido e uma longa cauda de extensões. Títulos, listas, links e ênfases funcionam bem. Tabelas, notas de rodapé, destaques, matemática e links internos, como [[Outra nota]], podem se comportar de forma diferente de um editor para outro.
Links de Wiki são especialmente dependentes do aplicativo. Outro editor pode deixá-los como texto comum se usar uma sintaxe diferente ou não conseguir encontrar a nota para a qual apontam. Antes de uma grande migração, exporte um pequeno conjunto contendo tabelas, links e tarefas, e depois inspecione-o no destino.
O Markdown não precisa substituir um editor confortável. Sua vantagem mais silenciosa é a propriedade: a escrita permanece inteligível fora do aplicativo que a criou.
A sintaxe suportada pelo Loknot está descrita em Markdown no Loknot.
Para a escolha entre .md, .txt e HTML, leia o guia de formatos de exportação.
Perguntas comuns
Um editor de texto comum pode abrir um arquivo .md?
Sim. É um arquivo de texto, então o conteúdo permanece legível. Um editor de Markdown é necessário apenas para uma visualização mais confortável e ferramentas de edição.
Qual é a diferença entre .md e .txt?
Ambos contêm texto. A extensão .md indica a um editor que interprete a pontuação de títulos, listas e links como Markdown.
Por que um link de wiki não é clicável em outro aplicativo?
Links de wiki não fazem parte do núcleo universal do Markdown. O aplicativo de destino deve suportar a mesma sintaxe e ser capaz de encontrar a nota vinculada.
Atualizado: