O Markdown permite focar no texto e, ao mesmo tempo, ter negrito, listas e blocos de código sem abrir um editor WYSIWYG.

Vantagens práticas

  • Os artigos ficam como arquivos no repositório
  • Diffs em pull request mostram exatamente o que mudou
  • É trivial gerar HTML estático ou servir com uma app em Python

Exemplo de código

def saudacao(nome: str) -> str:
    return f"Olá, {nome}!"

Menos atrito na publicação significa mais chances de eu realmente escrever.

Na prática, combino front matter (título, data, resumo) com o corpo em Markdown e deixo o Flask renderizar a página.