1001Ferramentas
🗂️ Conversores

Conversor Markdown → Org-mode

Conversor básico de Markdown para Org-mode: títulos com asteriscos (* ** ***), listas, link e blocos de código #+BEGIN_SRC.

Org-mode:

Markdown para Org Mode

Org Mode é o formato de anotação do Emacs e vai muito além de marcação: agenda, controle de tarefa, blocos de código executáveis e exportação para vários formatos. Quem migra notas de outra ferramenta para o Emacs precisa converter o Markdown que já tem, e as diferenças de sintaxe são grandes o bastante para o resultado ficar ilegível se colado direto.

Cole o Markdown e receba o Org. Os cabeçalhos trocam a cerquilha por asterisco, mantendo a contagem de níveis; a ênfase forte vira asterisco simples e a fraca vira barra; o link inverte a ordem e ganha o par de colchetes duplos característico; e o bloco de código cercado vira o par BEGIN_SRC e END_SRC, preservando a linguagem declarada na abertura da cerca, que é o que faz o Emacs colorir e executar o bloco.

Uma diferença estrutural que a conversão não pode resolver sozinha: no Org, o asterisco no começo da linha define a hierarquia do documento inteiro, e é ela que a agenda e o dobramento de seções usam. Se o Markdown original começava em cabeçalho de segundo nível, o Org resultante terá um nível vazio no topo — vale revisar a hierarquia depois de converter arquivo grande.

Perguntas frequentes

A linguagem do bloco de código é preservada?
É. A cerca de Markdown que declara a linguagem produz o BEGIN_SRC com essa linguagem, que é o que faz o Emacs colorir e, com o Babel, executar o bloco. Cerca sem linguagem produz BEGIN_SRC sem argumento, que funciona mas não colore.
Por que itálico vira barra?
É a convenção do Org: barra para ênfase, asterisco para negrito, sublinhado para sublinhado de fato e til para código literal. A diferença em relação ao Markdown é que o Org só reconhece esses marcadores quando cercados por espaço ou pontuação, então marcação no meio de uma palavra não pega.
Dá para converter de volta?
O próprio Emacs exporta Org para Markdown com o exportador embutido, e o resultado é bem melhor que uma conversão linha a linha, porque ele trabalha sobre a árvore já interpretada do documento. Para o caminho de volta, esse é o caminho recomendado.

Ferramentas Relacionadas