Eine native Mac-App für lokale Markdown-Notizen
MiaoYan ist das chinesische 妙言, Worte jenseits der Worte.
English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français
- 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
-
App Store (empfohlen, ein Kauf für iPhone, iPad und Mac, automatische Updates):
-
Homebrew:
brew install --cask miaoyan
-
GitHub Releases: Neueste DMG von GitHub Releases 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.
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
# Installation
curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash
# Verwendung
miao open <Titel|Pfad> # Notiz oder Ordner öffnen
miao new <Titel> [Text] # Neue Notiz erstellen
miao search <Suchbegriff> # Notizen im Terminal durchsuchen
miao list [Ordner] # Ordner der obersten Ebene oder Markdown-Dateien eines Ordners auflisten
miao cat <Titel|Pfad> # Notizinhalt ausgeben
miao update # CLI aktualisierenEditor und Vorschau stehen nebeneinander. Drücke ⌘\, um die geteilte Ansicht umzuschalten, oder stelle in den Einstellungen unter Editor den Default Mode auf Split. 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.
- Einführung in MiaoYan - Bedienungsanleitung und Tastenkürzel
- Markdown-Syntaxanleitung - Syntaxübersicht mit Formeln und Diagrammen
- PPT-Präsentationsmodus - Anleitung zur Folienerstellung mit
----Trennlinien - MiaoYan Agent Skill - 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.
- Die direkteste Unterstützung ist der Kauf von Mole for Mac, meiner Bereinigungs-App für macOS
- Wenn dir MiaoYan gefällt, vergib einen Stern, teile es 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
- glushchenko/fsnotes - Ursprüngliche Projektstruktur
- stackotter/swift-cmark-gfm - Swift Markdown-Parser
- simonbs/Prettier - Markdown-Formatierung
- raspu/Highlightr - Syntax-Highlighting
- hakimel/reveal.js - PPT-Präsentations-Framework
MIT License


