MDeX v2.4.0 (macOS · Windows · Linux · Tauri v2)

MDeX · ausgesprochen „em-dex" (/ˌemˈdɛks/) — der Buchstabe M gefolgt von „dex", zwei Silben.

Ein mehrsprachiger Markdown-Reader & Editor mit Fokus auf Datenschutz und AI-Unterstützung. Jede Datei wird lokal verarbeitet — standardmäßig kein Netzwerk, keine Uploads, keine Cloud-Synchronisation, keine Werbung, keine Telemetrie; atomares (absturzsicheres) Speichern verhindert Datenverlust bei Absturz oder Stromausfall. Seit v2.0 bietet MDeX zusätzlich ein optionales, KI-gestütztes Bearbeiten an — und das kann vollständig offline bleiben: ein lokales Modell (z. B. Ollama) benötigt kein Internet; nur ein Online-AI-Dienst (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi usw.) führt eine Anfrage aus, und auch das nur, wenn Sie ihn konfigurieren und aktiv aufrufen.

• Ein einzelnes, in sich geschlossenes HTML-Frontend (ohne Vue / React); Tauri v2 stellt lediglich die native Hülle bereit (Fenster, Menüs, Dateidialoge).
• Keine einzigen Netzwerk-Anfragen zur Laufzeit: marked / KaTeX / highlight.js / DOMPurify / mermaid / jsPDF / html2canvas-pro / turndown / @retorquere/bibtex-parser sowie sämtliche KaTeX-woff2-Fonts sind inline / base64-eingebettet in einer einzigen index.html.
• Unterstützt .md / .markdown / .html; kann als Standard-Handler für .md eingerichtet werden — per Doppelklick öffnen.

🌐 Languages

Die Benutzeroberfläche wird in 17 Sprachen ausgeliefert: English, 简体中文, Français, Deutsch, Español, Português, Italiano, Русский, 日本語, 한국어, العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл).

• Jederzeit über das Sprachmenü der Symbolleiste umschalten; Ihre Wahl wird über Sitzungen hinweg gespeichert.
• Arabisch wird automatisch rechts-nach-links (RTL) gerendert — Fließtext, Überschriften, Listenmarkierungen und die gesamte Symbolleiste spiegeln sich nach rechts; eingebettete Codeblöcke, LaTeX-Formeln, englische Fachbegriffe und Versionsnummern bleiben links-nach-links und werden niemals gespiegelt.
• Diese README selbst ist in alle 17 Sprachen übersetzt — verwenden Sie die Auswahl ganz oben auf dieser Seite.

✨ Funktionen

• Multi-Tab + Multi-Fenster: mehrere Dateien gleichzeitig öffnen; ungespeicherte Änderungen werden mit einem Punkt markiert und vor dem Schließen abgefragt; ein Tab lässt sich per Mittelklick schließen. Ein Doppelklick auf eine .md öffnet ein eigenes Fenster (eine Datei pro Fenster); ein Doppelklick auf eine bereits geöffnete Datei fokussiert dieses Fenster, statt sie erneut zu öffnen.
• Live Geteilte Vorschau: den Trenner ziehen, um die Größe anzupassen; die Symbolleisten-Schaltfläche durchschaltet Split / Editor / Vorschau.
• Klick-Positionierung: Klick im Editor scrollt die Vorschau; Klick in der Vorschau springt mit dem Cursor in den Editor.
• Suchen & Ersetzen: finden, einzelnes oder alle ersetzen, mit Trefferzähler.
• Formelsatz: inline $…$ und block $$…$$ (auch \(...\), \[...\]), gerendert durch KaTeX; lange Gleichungen brechen an Operatoren um oder schrumpfen automatisch.
• Code-Hervorhebung: Sprache wird automatisch erkannt; große Dokumente werden lazily nach Viewport hervorgehoben, um flüssig zu bleiben.
• Mermaid-Diagramme: ein ```mermaid-Block wird als Flussdiagramm / Sequenz / Klasse / Zustand / Gantt / Tortendiagramm usw. gerendert; klicken Sie auf ein Diagramm, um ein eigenständiges Zoom-/Pan-/Vollbild-Anzeigefenster zu öffnen, das sich beim Bearbeiten live aktualisiert.
• Bilder: einfügen / hineinziehen / auswählen — gespeichert in einem <Dateiname>_images/-Ordner neben dem Dokument mit einer sauberen relativen Referenz (kein Inline-Base64); Entwürfe nutzen einen temporären Ordner, der beim Speichern migriert wird; «Speichern unter» flacht die Bilder ins Ziel ab; standardmäßig zentriert.
• Schrift-Zoom: Editor- und Vorschau-Schriftarten unabhängig zoomen (−/Prozent/+ -Steuerung oder ⌘/Ctrl + =/−/0); bleibt über Neustarts hinweg bestehen.
• Tabellen: GFM-Tabellen; schmale Tabellen werden am Inhalt zentriert, breite scrollen horizontal ohne Abschneiden.
• Zitate (BibTeX): Syntax [@key] / \cite{key}, numerischer Stil; am Ende wird ein Literaturverzeichnis erstellt, mit bidirektionalen Sprüngen zwischen textinterner [n] und dem Eintrag; unterstützt einen eingebetteten ```bibtex-Block oder eine separat geladene .bib.
• HTML-Unterstützung: .html-Dateien zum Rendern öffnen; zwischen HTML und Markdown konvertieren.
• Design / Sprache: dunkel / hell, 17 UI-Sprachen (中文, English, Français, Deutsch, Русский, Italiano, 日本語, 한국어, Español, Português, العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл) — Arabisch & Urdu automatisch rechts-nach-links).
• Auto-Entwurf: Inhalte werden regelmäßig gespeichert und nach einem unerwarteten Schließen / Absturz wiederhergestellt.
• Wortzahl: die Statusleiste zeigt live Zeichen / Zeilen / Wörter sowie die aktuelle Zeile & Spalte.
• Drag-and-Drop: eine .md-Datei auf das Fenster ziehen, um sie zu öffnen; ein Bild ziehen, um es einzufügen.
• Export: speichern als Markdown / HTML / PDF (Vektor) / LaTeX.
• Textfarbe: Die Paletten-Schaltfläche schließt die Auswahl in <span style="color:…"> ein.
• KI-gestütztes Bearbeiten: Text auswählen und ⌘/Ctrl + J (oder die Symbolleisten-Schaltfläche) drücken, damit die AI ihn verfeinert, erweitert oder umformuliert; funktioniert mit Online-Diensten (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi usw.) sowie mit einem lokalen Modell wie Ollama, das vollständig offline arbeitet; das Ergebnis wird vor dem Ersetzen des Originals in der Vorschau angezeigt, und der API-Schlüssel wird nur lokal gespeichert.
• Zurück / Vor: vereinigte History über Dokumente und Cursorpositionen; ◀ ▶-Buttons, Alt+←/→.
• Links folgen: Ein Klick auf einen Link in der Vorschau öffnet das Ziel in einem neuen Tab (http im Systembrowser); das aktuelle Dokument bleibt erhalten.

📦 Installation

Prebuilt downloads

Download the installer for your platform from either source:

• GitHub Releases: https://github.com/fwzheng/mdex/releases
• Mirror site: https://www.spinss.cn/

Platforms: macOS (.dmg, arm64), Windows (.exe, NSIS installer), Linux (.deb / .rpm / .AppImage).

macOS

1. Open the .dmg file, drag MDeX.app into /Applications.

2. The app is unsigned (not notarized). On macOS 12+ - especially macOS 26 (Tahoe) - launching it fails with "MDeX.app is damaged and can't be opened." This is Gatekeeper, not real damage. Fix (choose one):

   Option A - Terminal (recommended):

   xattr -cr /Applications/MDeX.app
   codesign --force --deep --sign - /Applications/MDeX.app

   com.apple.provenance (new in macOS 26) is SIP-protected and can't be permanently removed; re-signing resets the signature so Gatekeeper lets it run.

   Option B - Finder right-click: In Finder, right-click (or Control-click) MDeX.app -> Open -> confirm "Open" in the dialog. This bypasses the double-click Gatekeeper check.

   Option C - System Settings: Double-click the app (let it be blocked), then go to System Settings -> Privacy & Security, scroll down, click "Open Anyway" next to the "MDeX.app was blocked" message.

3. Launch with open /Applications/MDeX.app or double-click. The first launch may still prompt once - confirm via System Settings -> Privacy & Security -> Open Anyway, or right-click -> Open.

Note: Every time you update MDeX (reinstall a new version), repeat step 2. The only permanent fix is Apple Notarization ($99/year Developer certificate).

Windows

1. Download MDeX_x.x.x_win.exe and double-click to run.
2. SmartScreen may show "Windows protected your PC" (because the app is unsigned). Click "More info" -> "Run anyway".
3. Follow the NSIS installer wizard to complete installation.
4. Launch from the Start Menu or desktop shortcut.

If Windows Defender quarantines the file, restore it: Windows Security -> Virus & threat protection -> Protection history -> Allow on device.

Linux

Debian / Ubuntu (.deb):

sudo dpkg -i MDeX_x.x.x_amd64.deb
# If missing dependencies:
sudo apt-get install -f

Then launch from the application menu or run mdex in terminal.

Fedora / RHEL (.rpm):

sudo rpm -i MDeX_x.x.x_x86_64.rpm

AppImage (all distros):

chmod +x MDeX_x.x.x_amd64.AppImage
./MDeX_x.x.x_amd64.AppImage

If AppImage won't launch, install FUSE: sudo apt install libfuse2 (Debian/Ubuntu) or sudo dnf install fuse (Fedora).

⌨️ Tastenkürzel

Auf macOS ⌘, auf Windows / Linux Ctrl verwenden.

Bei mehreren offenen Fenstern wirken sich Tastenkürzel nur auf das fokussierte Fenster aus. Wenn das Bildanzeige-Fenster geöffnet ist, zoomt ⌘/Ctrl + =/−/0 stattdessen das Bild.

📝 Spickzettel

Markdown: Überschriften # / ## / ###, fett **text**, kursiv *text*, durchgestrichen ~~text~~, Inline-Code `code`, Codeblöcke (dreifache Backticks, optional mit Sprache), Zitat > text, Listen - / 1., Aufgabenliste - [ ] / - [x], Link [text](url), Bild ![alt](url), Trennlinie ---, Tabellen | A | B |.

Formelsatz: inline $E = mc^2$; block $$\int_0^1 x\,dx$$ (darf mehrere Zeilen umfassen). Verwendet LaTeX-Syntax, gerendert durch KaTeX; $ innerhalb von Codeblöcken wird nicht als Formel-Trenner behandelt. Unterstützt align / aligned, Matrizen, cases und weitere gängige Umgebungen.

Zitate: im Text [@key] oder [@a; @b] schreiben (LaTeX-kompatibles \cite{key}), die Bibliothek über einen ```bibtex-Block einbetten oder eine .bib per „Refs"-Schaltfläche laden. Am Ende wird ein Literaturverzeichnis erstellt; das textinterne [n] ist klickbar.

📤 Export (Speichern unter)

Auf „Speichern unter" klicken und ein Format wählen:

• Markdown (.md): den Quelltext speichern und den Namen / Pfad des aktuellen Tabs aktualisieren.
• HTML (.html): in sich geschlossenes HTML mit inline CSS + Code-Hervorhebung; Formeln bleiben als $…$-Literal erhalten, automatisch durch inline KaTeX gerendert.
• PDF Vektor: System-Druckdialog, Vektorausgabe, bei jeder Vergrößerung scharf. „Als PDF speichern" wählen.
• LaTeX (.tex): konvertiert in eine kompilierbare .tex-Quelle (mit documentclass und Paketen; Formeln bleiben unverändert). Exportiert eine Kopie.

🔒 Offline & Sicherheit

• Keine einzigen Netzwerk-Anfragen zur Laufzeit. Das Build-Ergebnis dist/index.html wird selbst geprüft: keine externen src= / href= / url() / @import-Links.
• Striktes CSP (nur lokales IPC, kein WAN); alle Dateien werden lokal gelesen / geschrieben, nichts wird hochgeladen.
• Überprüfen: Wi-Fi ausschalten / Kabel ziehen und starten — Formelsatz, Bilder, Code-Hervorhebung und Mermaid funktionieren alle.
• dist/index.html zeigt weiterhin rund ein Dutzend https://github.com/…-Strings; diese befinden sich alle innerhalb der Lizenz-/Quell-Kommentare von marked / highlight.js usw. — reiner Text, der niemals eine Anfrage auslöst; unverändert belassen, um die Open-Source-Lizenzen zu respektieren.

🛠️ Aus dem Quellcode bauen

Quellcode: https://github.com/fwzheng/mdex. Bitte folgen Sie den Build-Anweisungen im Repository (Setup, Abhängigkeiten und Befehle sind dort dokumentiert).

📁 Projektstruktur

markdown/
├── app-shell.html          # frontend shell (HTML+CSS); app logic lives in src/app.js
├── src/
│   ├── app.js              # application logic (// @ts-check; inlined into dist by build-html.mjs)
│   ├── i18n.js            # 17-language UI strings (pure data; window.I18N, split from app.js)
│   ├── help.js            # help-document data (HELP_STRINGS + SK/sc/CITE_HELP_*, window.HELP_DATA)
│   └── globals.d.ts        # vendor / Window type declarations for type-checking
├── tsconfig.json           # type-check config (tsc --noEmit; no bundler)
├── tools/
│   ├── fetch-vendor.mjs    # one-time: download deps into vendor/ + integrity lock (online only here)
│   ├── build-html.mjs      # inline vendor + src/app.js + i18n.js + help.js into dist/index.html (KaTeX fonts → base64)
│   └── test-pure.mjs       # frontend pure-function tests (npm test)
├── dist/index.html         # build output: self-contained single file (Tauri frontendDist)
├── vendor/                 # download cache + integrity.json (.gitignore)
├── package.json            # @tauri-apps/cli + typescript(dev) + scripts
└── src-tauri/
    ├── Cargo.toml          # tauri 2 + dialog / single-instance + encoding_rs
    ├── build.rs            # tauri_build::build()
    ├── tauri.conf.json     # 1200×750 window, strict CSP, icons, .md association, menu hooks
    ├── capabilities/default.json
    ├── icons/              # full icon set from `cargo tauri icon`
    └── src/{main.rs, lib.rs}   # menus + file IO + multi-window routing + atomic write / file ownership

🎨 Anpassung

📄 Lizenz

Der eigene Code dieses Projekts ist Open Source unter Apache License 2.0.

Drittanbieter-Komponenten: Das Projekt verwendet einige Drittanbieter-Komponenten (unter anderem marked, KaTeX, highlight.js, DOMPurify, jsPDF, html2canvas-pro, turndown, mermaid, @retorquere/bibtex-parser und Tauri usw.); deren Urheber- und Lizenzhinweise finden sich in den jeweiligen Quelldateien. Diese Komponenten stehen jeweils unter MIT, BSD-3-Clause, Apache-2.0, MPL-2.0 und weiteren Open-Source-Lizenzen.

Weitergabeanforderungen: Gemäß der Apache-2.0-Lizenz muss bei Weitergabe dieses Projekts die Dateien LICENSE und NOTICE beibehalten werden; wenn Sie eine Quelldatei ändern, müssen Sie die Änderungen in der entsprechenden Datei deutlich kennzeichnen.

📬 Kontakt

Bei Problemen oder Vorschlägen: fw@spinss.cn