Markdown: organize o significado antes da aparência
Markdown ajuda em notas e documentação porque o arquivo-fonte continua legível como texto. Seu valor está em separar títulos, parágrafos e listas, não em acumular símbolos.
Título não é apenas tamanho de fonte
Comece pelo assunto do documento e coloque as seções em níveis inferiores. # e ## seguidos de espaço definem níveis diferentes; transformar toda linha em título principal elimina essa hierarquia.
Use listas para itens independentes e parágrafos para explicar relações. A formatação deve apoiar uma frase clara, não tomar seu lugar.
Referências: CommonMark 0.31.2 — Structured text, headings and rendering differences
A prévia não representa todo ambiente de publicação
As extensões de Markdown variam. Uma tabela funcionar em um editor não garante o mesmo resultado em outro sistema; confira o documento no destino em que será lido.
ToolRoof exibe e exporta HTML, mas não executa HTML bruto inserido. Imagens externas viram descrições e os links ficam inativos na prévia. Não é uma reprodução completa de páginas web.
Referências: CommonMark 0.31.2 — Structured text, headings and rendering differences
Guarde o original junto da versão exibida
O Markdown original facilita comparar alterações. HTML serve à apresentação, mas converter de volta não necessariamente recupera a fonte exata.
Revise conteúdo e links antes de compartilhar. A prévia não comprova fatos, segurança dos sites nem autorização para reutilizar material de terceiros.
Exemplo: uma nota curta de reunião
Escreva # Plano semanal, depois ## Prioridades e, em linhas separadas, - Revisar o resumo e - Enviar o rascunho. O resultado tem um título principal, um subtítulo e uma lista de 2 itens, não 4 parágrafos semelhantes.
#Plano semanal, sem espaço, não forma um título ATX. Código entre crases continua sendo texto exibido: a prévia não o executa nem confirma que esteja correto.