Guia · Excel → Markdown

Excel para Markdown: fórmulas e formatação

Uma tabela Markdown é um retângulo de texto. Uma planilha é um retângulo de células, e uma célula pode carregar uma fórmula embaixo, uma máscara de exibição em cima e uma mesclagem esticando-a sobre as vizinhas. Três dessas quatro não têm onde pousar.

O que deixa uma pergunta estreita: de tudo o que a planilha sabe, o que chega à tabela, e a parte que você veio buscar está entre isso?

Abrir o conversor

As fórmulas viram as respostas delas

=SUM(B2:B9) chega como 4211. Essa é a direção útil, porque o Markdown não calcula nada: uma fórmula colada ficaria no documento como caracteres inertes que parecem significar algo e não significam.

Funciona porque o Excel guarda em cache o valor calculado ao lado da fórmula cada vez que salva o arquivo. O conversor lê esse valor em cache, e é por isso que ele não precisa de um motor de fórmulas próprio e tudo isso consegue rodar em uma aba do navegador.

Célula no Excel
B10:  =SUM(B2:B9)
Markdown
| Total | 4211 |

As pastas que ninguém nunca abriu

Se a pasta de trabalho foi gerada por um script — uma exportação em Python, um processo de relatórios, qualquer coisa que use uma biblioteca de planilhas — e nunca foi aberta no Excel, não há valor em cache. Ninguém escreveu um. Essas células viram vazias.

Uma ida e volta resolve: abra a pasta no Excel ou no LibreOffice, salve, feche. Salvar é o que preenche o cache. E uma planilha que ainda assim é lida como vazia fica apontada acima da saída, então você não vai copiar uma tabela de vãos sem perceber.

Erros de fórmula também saem vazios, em vez de como #DIV/0! ou #REF!. Uma busca quebrada ao longo de uma coluna produz uma coluna de vãos, então se uma coluna está vazia sem motivo aparente, confira a origem.

Os formatos de número não sobrevivem

De tudo o que está nesta página, isto é o que vale ler antes de converter. O Excel guarda a máscara de exibição e o número armazenado em lugares diferentes, e só o número armazenado é dado: a máscara é uma instrução de renderização.

Por isso R$ 1.234,50 chega como 1234.5 e uma célula que mostra 12,50 % chega como 0.125. Nada foi estragado: esses são os números que o arquivo sempre teve, mostrados sem a máscara.

Se a formatação importa, acrescente na planilha uma coluna com a string já formatada, montada com uma fórmula TEXTO(), e use essa coluna. Aí é texto, e o texto chega exatamente como está escrito.

As datas são a exceção. Elas também são guardadas como números, mas o formato de número as identifica, então elas saem como 1995-01-01, com a hora acrescentada quando existe. Elas são lidas em UTC de propósito: a versão ingênua desloca cada data um dia para trás para qualquer pessoa a oeste de Greenwich.

As células mescladas se separam

Um título mesclado em A1:C1 vira uma célula com o texto e duas células vazias ao lado. O Excel guarda o valor na célula superior esquerda de uma mesclagem e deixa o resto realmente vazio, então é isso que há para ler.

O Markdown não tem colspan, então não há como montar de volta. Desfaça as mesclagens no Excel primeiro se o layout importar: muitas vezes elas só estavam ali para centralizar um título.

Cores, fontes, bordas, formatação condicional e comentários de célula vão pelo mesmo caminho e pela mesma razão: o Markdown não tem sintaxe para nada disso.

Planilhas, uma por vez ou várias

O título só aparece quando há mais de uma planilha selecionada. Com uma só você já sabe qual é, e um título seria ruído.

Linhas vazias no fim são cortadas primeiro, e isso importa mais do que parece: clicar por uma área vazia no Excel pode deixar uma planilha dizendo que tem várias centenas de linhas que não contêm nada. Uma planilha que fica vazia depois do corte avisa, em vez de produzir uma tabela de vãos.

  1. 01Solte a pasta de trabalho. Os nomes das planilhas voltam em uma lista com a contagem de linhas, e a primeira planilha é convertida.
  2. 02Marque as planilhas que quiser. Mudar a seleção gera a saída de novo a partir da cópia que já está na memória: o arquivo não é lido outra vez.
  3. 03Várias planilhas selecionadas saem como um único documento, cada tabela sob um título ## com o nome da planilha.

Os tetos de tamanho, e os arquivos que são recusados

10 MB por pasta de trabalho, mais baixo que os 25 MB dos outros formatos. Um .xlsx é um zip, e descompactá-lo em uma aba custa muito mais memória do que o tamanho do arquivo sugere.

100 000 células no total do que está selecionado, e é por isso que escolher menos planilhas pode fazer passar uma pasta grande que inteira não cabe.

Pastas protegidas por senha são recusadas em vez de lidas pela metade. O mesmo vale para os .xls binários antigos: os dois são contêineres OLE em vez de zips, e nenhum pode ser lido aqui. Abra no Excel e salve como .xlsx sem senha.

Se você soltar um .docx ou um PDF nesta página por engano, ela não vai tentar: o cabeçalho do arquivo é checado primeiro, e a mensagem nomeia a página que aceita aquilo.

Solte a pasta de trabalho, marque as planilhas que quiser, copie a tabela. O .xlsx é descompactado nesta aba e não vai a nenhum outro lugar, o que importa quando o arquivo é um modelo financeiro.

Excel → MD