Como funciona a tabela em GitHub Flavored Markdown (GFM)
Tabelas não faziam parte do Markdown original, mas são padrão no GitHub Flavored Markdown (GFM) — aceito hoje por GitHub, GitLab, Notion, Obsidian, wikis técnicas e renderizadores modernos como marked. A estrutura usa pipes (|) para delimitar colunas e uma linha separadora logo abaixo do cabeçalho com hifens e dois-pontos (---, :---:, ---:) para definir o alinhamento.
CSV do Excel em português: ponto-e-vírgula e Windows-1252
Quem exporta uma planilha no Brasil quase sempre esbarra em dois detalhes: o Excel PT-BR usa ; como delimitador (para não colidir com a vírgula decimal de valores como 349,90) e muitas vezes grava o arquivo em Windows-1252. O parser desta ferramenta detecta automaticamente vírgula, ponto-e-vírgula, tabulação e pipe, além de identificar UTF-8 vs. Windows-1252 na leitura de arquivos — evitando aquela tabela inteira espremida em uma coluna ou com acentos corrompidos.
Escape de pipe e células com várias linhas
Em GFM, cada linha do arquivo representa exatamente uma linha da tabela. Se uma célula do CSV tiver o caractere |, ele é escapado como \|; se tiver uma quebra de linha entre aspas no CSV original, ela é convertida para <br> com um aviso visível acima da saída. Assim a tabela nunca quebra a colagem no README ou PR.
Continue no fluxo de dados ou documentos
Precisa importar o mesmo CSV para alimentar uma API ou seed de banco? Use o Conversor de CSV para JSON. E depois de gerar sua tabela em Markdown, você também pode exportá-la em documento formatado com o Markdown para PDF, Markdown para Word ou Markdown para HTML.