Visualizador e editor de Markdown para macOS. Abra qualquer arquivo .md e veja um documento de verdade: renderizado, bonito e já editável. O que você salva é sempre markdown limpo.
Abrir um arquivo markdown no Mac normalmente significa cair num editor de código ou num preview estático. O Markdown Studio trata o .md como documento: tipografia editorial, edição no estilo de um processador de texto e fidelidade total entre o que você vê, o que salva e o que exporta.
- Modo Visual (padrão): edição rica com barra de ferramentas completa, como num editor de texto
- Modo Código: o markdown bruto num editor com numeração de linhas e busca própria, sincronizado com o Visual (alterne com ⇧⌘E)
- Formatação completa: títulos, negrito, itálico, sublinhado, tachado, código em linha, cores de texto, marca-texto, listas, listas de tarefas, citações, blocos de código, tabelas com menu de linhas e colunas, links, imagens e divisores
- Cores e sublinhado sobrevivem ao salvar: viram HTML em linha dentro do markdown, compatível com outros leitores
- Rascunho automático de sessão: feche o app de qualquer jeito e reabra com tudo no lugar, incluindo alterações não salvas
- O disco é a verdade: se o arquivo mudar por fora (git pull, outro editor, um script), o app recarrega o documento limpo ou mostra um aviso de conflito com as opções "Recarregar do disco" e "Manter meu rascunho"
- Nenhuma escolha destrutiva: o rascunho descartado num conflito pode ser recuperado com ⇧⌘T, assim como abas fechadas
- Salvar nunca sobrescreve mudanças externas em silêncio: o app confere o disco antes de gravar
- Abas para vários arquivos (aparecem só quando há mais de um)
- Estrutura do documento (⌥⌘O): painel lateral com os títulos, clique para navegar
- Busca no documento (⌘F) com destaque de todas as ocorrências e contador
- Zoom do texto (⌘ mais, ⌘ menos, ⌘0), persistido entre sessões
- Arraste arquivos
.mdpara a janela para abrir
- PDF, HTML, Word (DOCX) e RTF com a mesma tipografia do app (fontes embutidas no arquivo exportado)
- O PDF é gerado pelo mesmo motor de renderização do app (WebKit nativo): o arquivo exportado fica idêntico ao documento na tela, com paginação A4 que respeita as quebras entre blocos
- Impressão (⌘P) gera o PDF e abre no Pré-Visualização
- DOCX e RTF usam o conversor nativo do sistema (textutil)
| Ação | Atalho |
|---|---|
| Abrir arquivo | ⌘O |
| Novo documento | ⌘N |
| Salvar / Salvar como | ⌘S / ⇧⌘S |
| Alternar Visual e Código | ⇧⌘E |
| Buscar no documento | ⌘F |
| Estrutura do documento | ⌥⌘O |
| Fechar aba / reabrir aba | ⌘W / ⇧⌘T |
| Navegar entre abas | ⌘1 a ⌘9, ⌃Tab, ⇧⌘[ e ⇧⌘] |
| Zoom do texto | ⌘+, ⌘−, ⌘0 |
| Painel de atalhos | ⌘/ |
- Baixe o arquivo
.dmgda última release - Abra o
.dmge arraste o Markdown Studio para a pasta Aplicativos - Abra normalmente: as releases são assinadas com Developer ID e notarizadas pela Apple, sem avisos de segurança
Se preferir, compile você mesmo a partir do código (seção Desenvolvimento abaixo).
Requisitos: macOS 12 ou superior, Apple Silicon ou Intel.
O projeto inteiro roda com Bun: frontend, backend desktop e empacotamento.
git clone https://github.com/SEU_USUARIO/markdown-studio.git
cd markdown-studio
bun install # também gera os arquivos derivados (fontes embutidas)
bun run dev # API local na porta 4519 e Vite na 5173Qualidade:
bun run typecheck # TypeScript estrito
bun run lint # Biome
bun run test # Vitest (21 testes: roundtrip de markdown, sessão, conflito de disco, watcher, updater)Gerar o aplicativo:
bun run build:app # produz "build/Markdown Studio.app"
bun run build:dmg # também gera o instalador em release/O build assina e notariza automaticamente quando encontra um certificado Developer ID Application no Keychain e um perfil do notarytool chamado mdstudio-notary; sem eles, gera o app sem assinatura, suficiente para uso local.
.app
└── launcher → binário único (bun build --compile)
├── janela nativa WKWebView (webview-bun)
└── Worker: servidor Bun em 127.0.0.1, porta aleatória, com token de sessão
├── frontend React embutido no binário (Vite, TipTap, CodeMirror)
└── API local: arquivos, diálogos nativos, sessão, exportações
Pontos de interesse:
- A fonte da verdade é a string markdown; TipTap (Visual) e CodeMirror (Código) são visões sincronizadas
- A sessão (abas, conteúdo, rascunhos) é gravada com debounce em
~/Library/Application Support/MarkdownStudio/session.json - Exportações partem do mesmo HTML que o app renderiza, com CSS e fontes embutidos, garantindo fidelidade
- A barra de menus nativa (Objective-C) e o conversor de PDF (Swift/WebKit) são compilados e embutidos no app durante o build
- Stack: Bun, TypeScript estrito, React 19, Vite, Tailwind CSS 4, TipTap 2, CodeMirror 6, Vitest, Biome
O app verifica novas versões nas releases do GitHub ao abrir e mostra um aviso quando há uma disponível. Em um clique, ele baixa a nova versão, confere a assinatura e a notarização da Apple, e se reinstala sozinho. Não é preciso voltar ao GitHub manualmente.
- Apenas macOS (a janela nativa, os diálogos e a barra de menus usam recursos do sistema)