Eine native Mac-App für lokale Markdown-Notizen
MiaoYan ist das chinesische 妙言, Worte jenseits der Worte.
English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français
## Funktionen
- **Lokal zuerst**: Notizen sind Markdown-Dateien in einem Ordner deiner Wahl, ohne Datenerfassung; den Abgleich zwischen Geräten übernimmt iCloud Drive oder Nutstore
- **Fokussiert**: Ordner, Notizen und Editor in drei Spalten, mit Dark Mode und ohne Plugin-System, das gepflegt werden muss
- **Nativ**: Mit Swift 6 gebaut, leichter als Web-Wrapper, geteilte Vorschau mit 60fps-Bildlaufsynchronisation
- **Gut ausgestattet**: Wikilinks, LaTeX, Mermaid, Versionsverlauf, automatische Formatierung und PPT-Präsentationen integriert
## Installation
1. **App Store** (empfohlen, ein Kauf für iPhone, iPad und Mac, automatische Updates):
2. **Homebrew**:
```bash
brew install --cask miaoyan
```
3. **GitHub Releases**: Neueste DMG von [GitHub Releases](https://github.com/tw93/MiaoYan/releases/latest) herunterladen (macOS 12.0+)
Homebrew und GitHub Releases installieren dieselbe kostenlose Open-Source-Mac-App, die weiterentwickelt wird. Empfohlen ist die App-Store-Version: Ein Kauf gilt für iPhone, iPad und Mac, alle öffnen denselben iCloud-Drive-Ordner, und Updates kommen automatisch.
## Synchronisation mit Nutstore oder anderen Cloud-Diensten
MiaoYan meldet sich nicht bei WebDAV oder Cloud-Diensten an; es liest und schreibt ausschließlich im ausgewählten Markdown-Ordner. Erstelle nach der Installation einen `MiaoYan`-Ordner in iCloud Drive, im vom Nutstore-Desktop-Client synchronisierten Verzeichnis oder an einem beliebigen Ort und lege ihn in den Einstellungen (⌘,) als Speicherpfad fest. Die Synchronisation zwischen Geräten übernehmen iCloud Drive, Nutstore, Dropbox oder andere Clients.
- **iPhone**: Wähle denselben Ordner in der Dateien-App aus, und falls ein Anbieter dort keinen beschreibbaren Ordner bereitstellt, nutze iCloud Drive oder lade den Ordner vorher für den Offline-Zugriff herunter
- **Ordnerprüfung**: MiaoYan prüft vor dem Wechsel die Lese- und Schreibberechtigung und behält den bestehenden Pfad, wenn der Ordner nicht verfügbar ist, ohne das Problem als Synchronisationsfehler von MiaoYan zu melden
## Befehlszeilenwerkzeug (CLI)
```bash
# Installation
curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash
# Verwendung
miao open
## Dokumentation
- [Einführung in MiaoYan](Resources/Initial/Introduction%20to%20MiaoYan.md) - Bedienungsanleitung und Tastenkürzel
- [Markdown-Syntaxanleitung](Resources/Initial/MiaoYan%20Markdown%20Syntax%20Guide.md) - Syntaxübersicht mit Formeln und Diagrammen
- [PPT-Präsentationsmodus](Resources/Initial/MiaoYan%20PPT.md) - Anleitung zur Folienerstellung mit `---`-Trennlinien
- [MiaoYan Agent Skill](skills/miaoyan) - Bringt KI-Agenten MiaoYan-Syntax, Anhänge, PPT-Strukturen und CLI-Abläufe bei
Installiere den offiziellen Skill mit `npx skills add tw93/MiaoYan/skills/miaoyan -g`.
## Unterstützung
- Die direkteste Unterstützung ist der Kauf von [Mole for Mac](https://mole.fit), meiner Bereinigungs-App für macOS
- Wenn dir MiaoYan gefällt, vergib einen Stern, [teile es](https://twitter.com/intent/tweet?url=https://github.com/tw93/MiaoYan&text=MiaoYan%20-%20Eine%20native%20Mac-App%20f%C3%BCr%20lokale%20Markdown-Notizen) oder eröffne ein Issue oder einen PR
- Ich habe zwei Katzen, TangYuan und Coke. Wenn dir MiaoYan Freude bereitet, kannst du ihnen etwas Dosenfutter 🥩 spendieren