Une app Mac native pour vos notes Markdown locales
MiaoYan vient du chinois 妙言, des mots au-delà des mots.
English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français
## Fonctionnalités
- **Local d'abord** : les notes sont des fichiers Markdown dans le dossier de votre choix, sans collecte de données, et iCloud Drive ou Nutstore assure la synchronisation entre appareils
- **Épuré** : dossiers, notes et éditeur sur trois colonnes, avec mode sombre et sans système d'extensions à maintenir
- **Natif** : écrit en Swift 6, plus léger qu'un wrapper web, avec un défilement synchronisé à 60 fps dans l'aperçu divisé
- **Bien équipé** : wikilinks, LaTeX, Mermaid, historique des versions, mise en forme automatique et présentations PPT intégrés
## Installation
1. **App Store** (recommandé, un seul achat pour iPhone, iPad et Mac, mises à jour automatiques) :
2. **Homebrew** :
```bash
brew install --cask miaoyan
```
3. **GitHub Releases** : téléchargez le dernier DMG depuis [GitHub Releases](https://github.com/tw93/MiaoYan/releases/latest) (macOS 12.0+)
Homebrew et GitHub Releases installent la même application Mac gratuite et open source, qui continue d'évoluer. La version App Store est recommandée : un seul achat couvre l'iPhone, l'iPad et le Mac, qui ouvrent tous le même dossier iCloud Drive, avec des mises à jour automatiques.
## Synchronisation avec Nutstore ou d'autres services cloud
MiaoYan ne se connecte pas à WebDAV ni à des comptes cloud ; il lit et écrit uniquement dans le dossier Markdown choisi. Après l'installation, créez un dossier `MiaoYan` dans iCloud Drive, dans le répertoire synchronisé par le client de bureau Nutstore ou à l'emplacement de votre choix, puis ouvrez les Préférences (⌘,) et définissez-le comme emplacement de stockage. La synchronisation entre appareils est assurée par iCloud Drive, Nutstore, Dropbox ou un autre client.
- **iPhone** : sélectionnez le même dossier dans l'application Fichiers, et si un fournisseur n'y propose pas de dossier modifiable, utilisez iCloud Drive ou rendez le dossier disponible hors ligne au préalable
- **Vérification du dossier** : MiaoYan vérifie les accès en lecture et écriture avant de changer d'emplacement et conserve le chemin actuel si le dossier est inaccessible, sans signaler le problème comme une erreur de synchronisation de MiaoYan
## Interface en ligne de commande (CLI)
```bash
# Installation
curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash
# Utilisation
miao open
## Documentation
- [Présentation de MiaoYan](Resources/Initial/Introduction%20to%20MiaoYan.md) - Guide d'utilisation et raccourcis clavier
- [Guide de syntaxe Markdown](Resources/Initial/MiaoYan%20Markdown%20Syntax%20Guide.md) - Référence de syntaxe avec formules et diagrammes
- [Mode présentation PPT](Resources/Initial/MiaoYan%20PPT.md) - Guide de création de présentations avec séparateurs `---`
- [MiaoYan Agent Skill](skills/miaoyan) - Enseigne aux agents la syntaxe MiaoYan, la gestion des pièces jointes, les présentations et le CLI
Installez le skill officiel avec `npx skills add tw93/MiaoYan/skills/miaoyan -g`.
## Soutien
- La façon la plus directe de me soutenir est d'acheter [Mole for Mac](https://mole.fit), mon application de nettoyage pour Mac
- Si MiaoYan vous est utile, laissez une étoile, [partagez-le](https://twitter.com/intent/tweet?url=https://github.com/tw93/MiaoYan&text=MiaoYan%20-%20Une%20app%20Mac%20native%20pour%20vos%20notes%20Markdown%20locales) ou ouvrez une issue ou une PR
- J'ai deux chats, TangYuan et Coke. Si MiaoYan vous apporte satisfaction, vous pouvez leur offrir de la pâtée 🥩