Markdown é uma linguagem de marcação leve que usa sinais simples de texto para formatar um documento, criada por John Gruber em 2004. Você escreve # para título, asteriscos para destaque, hífens para listas e colchetes com parênteses para links, e essas marcas viram HTML formatado. A ideia é que o texto continue legível mesmo sem ser convertido, ao contrário do HTML cheio de tags. Por ser rápido de escrever e fácil de versionar, o Markdown virou padrão em arquivos README, documentação, fóruns como o GitHub e ferramentas de anotação e mensagens.

O GitHub Flavored Markdown (GFM) é uma extensão do Markdown padrão com recursos que faltavam no formato original. Ele acrescenta tabelas montadas com barras verticais e hífens, listas de tarefa com caixas de marcar, texto riscado entre dois tis e blocos de código cercados por três crases com realce de sintaxe por linguagem. Também transforma URLs soltas em links automaticamente. Esses recursos cobrem a maior parte do que se escreve em documentação técnica, e é o dialeto que este visualizador segue, então o preview reflete de perto como o texto apareceria no próprio GitHub.

O Markdown padrão permite misturar HTML no meio do texto, mas aqui esse HTML embutido é ignorado por segurança. O motivo é evitar ataques de cross-site scripting (XSS): se a ferramenta renderizasse qualquer tag colada, um trecho com uma tag de script ou um atributo malicioso poderia executar código no seu navegador. Ao tratar essas tags como texto simples, o preview mostra o Markdown com fidelidade sem abrir essa brecha. Para a maioria dos documentos isso não faz falta, já que a própria sintaxe do Markdown cobre títulos, listas, links, imagens e tabelas sem precisar recorrer a HTML manual.