MiaoYan

Eine native Mac-App für lokale Markdown-Notizen

MiaoYan ist das chinesische 妙言, Worte jenseits der Worte.

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

Twitter Follow Telegram GitHub Downloads GitHub Commit Activity GitHub Closed Issues macOS 12.0+
## 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): 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 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 # Notiz oder Ordner öffnen miao new [Text] # Neue Notiz erstellen miao search # Notizen im Terminal durchsuchen miao list [Ordner] # Ordner der obersten Ebene oder Markdown-Dateien eines Ordners auflisten miao cat # Notizinhalt ausgeben miao update # CLI aktualisieren ``` ## Geteilte Ansicht (Editor & Vorschau) Editor und Vorschau stehen nebeneinander. Drücke `⌘\`, um die geteilte Ansicht umzuschalten, oder stelle in den Einstellungen unter General den Editor Mode auf Split Mode. 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 - [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
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