showmd

O que é showmd?

showmd é uma extensão gratuita do Quick Look para macOS que pré-visualiza arquivos Markdown (.md e extensões relacionadas) de forma mais legível que o comportamento padrão do Finder. Seu propósito principal é renderizar Markdown com formatação, mantendo acesso ao conteúdo fonte.

Em vez de mostrar texto bruto ao pressionar Espaço em um arquivo .md no Finder, showmd renderiza o Markdown e oferece alternância renderizado/fonte. Além disso, analisa YAML frontmatter em uma tabela de metadados recolhível, suportando fluxos de trabalho comuns de documentação e prompts de IA que dependem da estrutura Markdown.

Principais Recursos

• Pré-visualização Quick Look para Markdown no Finder: Pressione Espaço em um arquivo Markdown para ver a saída formatada sem abrir navegador ou editor.
• Alternância renderizado ↔ fonte: Alterne entre Markdown renderizado e fonte bruta com um clique.
• YAML frontmatter como tabela de metadados recolhível: Detecta “chaves encontradas” no frontmatter e exibe em tabela recolhida por padrão.
• Recursos Markdown via parser Markdown: Suporta elementos GitHub Flavored Markdown como tabelas, listas de tarefas, riscado, autolinks, notas de rodapé e mais.
• Renderização consciente de sintaxe para código e conteúdo especial: Blocos de código usam realce por linguagem (190+ idiomas listados), LaTeX inline e em bloco renderiza via KaTeX, e diagramas Mermaid renderizam de blocos de código.
• Renderização de tags orientada a IA: Tags semelhantes a XML comuns em prompts de IA (ex.: , , ) renderizam como blocos rotulados e com bordas em vez de colchetes angulares brutos.
• Sem nuvem ou uploads em segundo plano descritos: A página afirma “No cloud. No uploads. No telemetry”, significando que arquivos são pré-visualizados localmente por padrão.
• Manipulação de imagens inline no Quick Look: Caminhos relativos de imagens resolvem corretamente para que capturas/diagramas locais apareçam na pré-visualização.

Como Usar showmd

1. Baixe showmd para macOS e abra uma vez.
2. Em Configurações do Sistema → Privacidade e Segurança → Extensões → Quick Look, ative showmd (a página descreve como um único toggle).
3. No Finder, selecione um arquivo Markdown e pressione Espaço para pré-visualizá-lo com showmd.
4. Use a alternância renderizado/fonte para alternar entre saída formatada e Markdown subjacente. A página também menciona opção de copiar como HTML.

Casos de Uso

• Lendo documentação armazenada como Markdown: Pré-visualize arquivos README com cabeçalhos, listas, links e tabelas formatados, sem sair do Finder.
• Inspecionando arquivos de prompt/config de IA em Markdown: Veja arquivos de instrução de agente IA onde o conteúdo inclui tags semelhantes a XML, com tags renderizadas como blocos rotulados para escaneamento mais rápido.
• Revisando YAML frontmatter em conteúdo de site estático: Expanda a tabela frontmatter quando precisar verificar títulos ou chaves de configuração, mantendo recolhida na leitura casual.
• Verificando conteúdo técnico com código, matemática ou diagramas: Veja blocos de código com realce de sintaxe, expressões LaTeX e fluxogramas Mermaid renderizados inline em vez de texto bruto.
• Verificando imagens relativas em notas/docs locais/repo: Confirme que imagens referenciadas por caminhos relativos aparecem corretamente na pré-visualização Quick Look.

FAQ

Como ativar showmd no Finder?
Baixe showmd, abra uma vez, vá para Configurações do Sistema → Privacidade e Segurança → Extensões → Quick Look e ative a extensão. No primeiro lançamento, macOS pode pedir permissão para acessar dados de outros apps; clique Permitir.

showmd substitui a necessidade de abrir um navegador?
A página apresenta showmd como forma de pré-visualizar Markdown diretamente no Quick Look do macOS, em vez de abrir navegador para ver saída renderizada.

Posso alternar entre saída renderizada e Markdown original?
Sim. showmd oferece alternância renderizado e fonte, descrita como um clique.

Como showmd lida com YAML frontmatter?
Analisa YAML frontmatter em uma tabela recolhível, recolhida por padrão, que você pode expandir para ver metadados.

Há componente de nuvem?
A página afirma “No cloud. No uploads. No telemetry”, indicando que pré-visualizações são tratadas localmente por padrão.

Alternativas

• Abrir arquivos Markdown em um visualizador/editor dedicado para Markdown: Use um app projetado para renderização e exportação de Markdown. Essas opções geralmente incluem mais ferramentas de edição, enquanto o showmd é posicionado especificamente como um pré-visualizador Quick Look.
• Usar um renderizador Markdown baseado em navegador: Faça upload ou cole o conteúdo em um visualizador online para obter a saída renderizada. Em comparação com o showmd, isso adiciona uma etapa no navegador e pode não manter os arquivos estritamente locais.
• Confiar no Quick Look padrão do macOS: A pré-visualização Espaço do Finder mostrará a fonte Markdown bruta. É o mais simples, mas menos legível para conteúdo formatado como tabelas, diagramas e matemática.
• Usar uma cadeia de ferramentas de documentação/site estático para pré-visualizar conteúdo: Servidores de desenvolvimento locais podem renderizar Markdown com estilo completo do site, mas são tipicamente mais pesados que um fluxo de trabalho de pré-visualização Quick Look.