Marky: Um Visualizador Leve de Markdown para Documentação Gerada por Agentes

O que o Marky faz

Marky é um aplicativo nativo para desktop macOS que oferece renderização rápida de arquivos markdown com foco na integração com o terminal. Você pode iniciá-lo com marky NOME_DO_ARQUIVO para visualizar um único arquivo ou marky PASTA para abrir uma pasta como um workspace persistente.

Principais Funcionalidades

• Fluxo de trabalho prioritário pela CLI: Abra arquivos diretamente a partir de comandos do terminal
• Recarregamento em tempo real: Edições no disco atualizam a visualização instantaneamente, útil para visualizar planos ou documentação gerados pelo Claude enquanto são escritos
• Workspaces de pastas: Adicione pastas como workspaces persistentes que aparecem em uma barra lateral e são restaurados na inicialização
• Paleta de comandos: Cmd+K para busca difusa de arquivos em todas as pastas abertas usando nucleo
• Realce de sintaxe: Shiki com temas do VS Code para blocos de código precisos
• Suporte a matemática: Renderização KaTeX para matemática $inline$ e $$display$$
• Diagramas: Blocos Mermaid renderizados como SVG
• Suporte a GFM: Tabelas, listas de tarefas, tachado, autolinks, notas de rodapé
• Temas claro e escuro: Segue a preferência do sistema ou alternância manual
• Renderização sanitizada: Todo HTML passa pelo DOMPurify para visualização segura de markdown não confiável
• Pequena pegada: Webview nativa (sem Electron) com .dmg de produção abaixo de 15 MB

Instalação

Atualmente disponível via Homebrew (nota: o aplicativo não está assinado enquanto aguarda revisão do desenvolvedor da Apple):

brew tap GRVYDEV/tap
brew install --cask GRVYDEV/tap/marky
xattr -cr /Applications/Marky.app

Ou compile a partir do código-fonte (requer Rust, Node.js e pnpm):

git clone https://github.com/GRVYDEV/marky.git
cd marky
pnpm install
pnpm tauri build
./scripts/install-cli.sh

Atalhos de Teclado

• Cmd+K: Paleta de comandos (busca difusa de arquivos)
• Cmd+O: Abrir arquivo
• Cmd+Shift+O: Adicionar pasta
• Cmd+F: Buscar na página

Stack Técnico

• Shell do desktop: Tauri v2
• Frontend: React + TypeScript + Vite
• Markdown: markdown-it
• Primitivos de UI: shadcn/ui
• Estilização: Tailwind CSS
• Monitoramento de arquivos: notify

Planejamento Futuro

O desenvolvedor planeja adicionar suporte a x86 e Linux (atualmente apenas macOS ARM), chat de IA integrado para interagir com Claude Code ou Codex diretamente dentro de documentos markdown, e funcionalidade de revisão de diff git para revisão de código local.