Sobre o projeto

MiaoYan é um aplicativo leve de anotações Markdown para macOS, posicionado como uma ferramenta de escrita local-first. É distribuído como um app nativo em Swift 6 e requer macOS 12.0 ou posterior. Recursos principais descritos no README: - Armazenamento local-first sem coleta de dados. As notas são arquivos Markdown simples mantidos em uma pasta escolhida pelo usuário. - Modo de editor e pré-visualização divididos com pré-visualização em tempo real e sincronização de rolagem bidirecional; alternado com Cmd+\ ou via Preferências. - Suporte a backlinks de wikilinks, LaTeX e Mermaid. - Layout minimalista de três colunas, modo escuro e um ambiente de escrita sem distrações. - Histórico de versões, atalhos de teclado e formatação automática. - Uma interface de linha de comando instalada por um script de shell, com comandos para abrir, criar, pesquisar, listar e imprimir notas, além de um comando de autoatualização. - Documentação cobrindo a sintaxe Markdown, um modo de apresentação em PPT usando separadores de slide ---, e uma skill de agente instalável com npx skills add. As opções de instalação listadas são a Mac App Store (paga, com atualizações automáticas), Homebrew via brew install --cask miaoyan, e downloads de DMG no GitHub Releases. Diz-se que as três compartilham a mesma base de código e atualizações. Após a instalação, os usuários criam uma pasta MiaoYan no iCloud Drive ou em outro local e definem o caminho de armazenamento em Preferências. A sincronização é tratada externamente: o MiaoYan não faz login em contas WebDAV ou de drive na nuvem. Em vez disso, ele lê e grava na pasta Markdown escolhida, e clientes como iCloud Drive, Nutstore ou Dropbox realizam a sincronização entre dispositivos. O app verifica o acesso de leitura e gravação antes de trocar de pasta e mantém o caminho atual se a nova pasta estiver indisponível. O README afirma que o projeto é licenciado sob MIT e reconhece várias dependências de código aberto para análise de Markdown, formatação, realce de sintaxe e renderização de apresentações. Também observa que o autor oferece um app Mac pago separado como forma de apoio.