MiaoYan

Eine ruhige, ablenkungsfreie Schreib-App für macOS

English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français

Twitter Follow Telegram GitHub Downloads GitHub Commit Activity GitHub Closed Issues macOS 12.0+
## Funktionen - **Lokal zuerst**: Notizen bleiben auf dem Mac, kein Cloud-Zwang, kein Tracking. - **Fokus durch drei Spalten**: Aufgeräumte Oberfläche mit Dark Mode, frei von Plugin-Ballast. - **Nativer Swift-Kern**: Schneller und leichtgewichtiger als Web-Wrapper, mit flüssiger geteilter Vorschau. - **Vielseitig**: Wikilinks, mathematische Formeln, Diagramme und Präsentationen direkt einsatzbereit. ## Installation 1. **Mac App Store** (kostenpflichtig, automatische Updates, inklusive iPhone- und iPad-App): Laden im Mac App Store 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 die Open-Source-Version, die ausschließlich Fehlerbehebungen erhält. Die Mac App Store-Version wird separat entwickelt, enthält die Apps für iPhone und iPad und bietet neue Funktionen. Erstelle nach der Installation einen `MiaoYan`-Ordner in iCloud Drive, einem lokalen Cloud-Sync-Ordner oder an einem beliebigen Ort und lege den Speicherpfad in den Einstellungen (⌘,) fest. ## Synchronisation mit Nutstore oder anderen Cloud-Diensten MiaoYan folgt dem Local-First-Prinzip und meldet sich nicht bei WebDAV oder Cloud-Diensten an. Die App liest und schreibt ausschließlich im ausgewählten Markdown-Ordner; die Synchronisation zwischen Geräten übernehmen iCloud Drive, Nutstore, Dropbox oder andere Clients. - **Mac**: Erstelle einen `MiaoYan`-Ordner im vom Desktop-Client synchronisierten Verzeichnis und verweise in den Einstellungen darauf. - **iPhone**: Wähle denselben Ordner in der Dateien-App aus. Falls ein Anbieter 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. Ist der Ordner nicht verfügbar, bleibt der bestehende Pfad unverändert. ## Befehlszeilenwerkzeug (CLI) MiaoYan enthält ein CLI für schnelle Aktionen direkt im Terminal. ```bash # Installation curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash # Verwendung miao open # Notiz oder Ordner öffnen miao new [Text] # Neue Notiz erstellen miao search # Notizen im Terminal durchsuchen miao list [Ordner] # Ordner oder Notizen auflisten miao cat # Notizinhalt ausgeben miao update # CLI aktualisieren ``` ## Geteilte Ansicht (Editor & Vorschau) Bearbeiten und Vorschau nebeneinander mit Echtzeitvorschau und synchronem 60fps-Bildlauf in beide Richtungen. **Schnellwechsel**: Drücke `⌘\`, um die geteilte Ansicht umzuschalten, oder aktiviere sie unter Einstellungen → Oberfläche → Bearbeitungsmodus → Geteilter Modus. Warum kein Typora-ähnliches WYSIWYG? Reines Markdown-Schreiben ist das Kernprinzip. Ein natives Swift-WYSIWYG wäre schwerfällig und instabil. Die geteilte Ansicht ermöglicht ablenkungsfreies Schreiben bei sofortigem visuellem Feedback. Geteilte Ansicht (Editor & Vorschau) ## Dokumentation - [Markdown-Syntaxanleitung](Resources/Initial/MiaoYan%20Markdown%20Syntax%20Guide.md) - Vollständige Syntaxübersicht mit erweiterten Funktionen - [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-%20A%20fast%2C%20elegant%20Markdown%20editor%20for%20Mac.) 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.
Unterstützer 🐱
## Danksagung - [glushchenko/fsnotes](https://github.com/glushchenko/fsnotes) - Ursprüngliche Projektstruktur - [stackotter/swift-cmark-gfm](https://github.com/stackotter/swift-cmark-gfm) - Swift Markdown-Parser - [simonbs/Prettier](https://github.com/simonbs/Prettier) - Markdown-Formatierung - [raspu/Highlightr](https://github.com/raspu/Highlightr) - Syntax-Highlighting - [hakimel/reveal.js](https://github.com/hakimel/reveal.js) - PPT-Präsentations-Framework ## Lizenz MIT License - Freie Nutzung und Mitwirkung willkommen.