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

MDeX · si pronuncia "em-dex" (/ˌemˈdɛks/) — la lettera M seguita da "dex", due sillabe.

Un lettore ed editor Markdown multilingue focalizzato su privacy e assistenza AI. Ogni file viene elaborato localmente — nessuna rete, nessun caricamento, nessuna sincronizzazione cloud, nessuna pubblicità, nessuna telemetria per impostazione predefinita; i salvataggi atomici (a prova di crash) evitano la perdita di dati in caso di crash o interruzione di corrente. A partire dalla v2.0, MDeX offre anche la modifica assistita dall'IA opzionale — e può rimanere completamente offline: un modello locale (es. Ollama) non necessita di internet; solo un servizio AI online (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi, ecc.) effettua una richiesta, e solo quando lo configuri e lo attivi.

• Un singolo frontend HTML autonomo (niente Vue / React); Tauri v2 fornisce solo la shell nativa (finestre, menu, finestre di dialogo file).
• Zero richieste di rete a runtime: marked / KaTeX / highlight.js / DOMPurify / mermaid / jsPDF / html2canvas-pro / turndown / @retorquere/bibtex-parser e tutti i font woff2 di KaTeX sono inline / incorporati in base64 in un unico index.html.
• Supporta .md / .markdown / .html; può essere impostato come gestore predefinito dei .md — doppio clic per aprire.

🌐 Lingue

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

• Cambia in qualsiasi momento dal menu lingua della barra strumenti; la tua scelta viene ricordata tra le sessioni.
• L'arabo viene reso da destra a sinistra (RTL) automaticamente — il corpo del testo, le intestazioni, i marcatori delle liste e l'intera barra degli strumenti si riflettono a destra; i blocchi di codice incorporati, la matematica LaTeX, i termini inglesi e i numeri di versione rimangono da sinistra a destra, mai riflessi.
• Questo README è a sua volta tradotto in tutte le 17 lingue — usa il selettore in cima a questa pagina.

✨ Funzionalità

• Multi-scheda + multi-finestra: apri più file contemporaneamente; le modifiche non salvate sono contrassegnate con un puntino e ti viene chiesto prima di chiudere; clic centrale su una scheda per chiuderla. Il doppio clic su un .md apre una propria finestra (una finestra per file); il doppio clic su un file già aperto porta in primo piano quella finestra invece di riaprirlo.
• Anteprima affiancata in tempo reale: trascina il divisore per ridimensionare; il pulsante della barra strumenti alterna Diviso / Editor / Anteprima.
• Posizionamento con clic: clicca nell'editor per scorrere l'anteprima; clicca nell'anteprima per spostare il cursore nell'editor.
• Cerca e sostituisci: trova, sostituisci uno o tutti, con conteggio delle corrispondenze.
• Matematica: inline $…$ e blocco $$…$$ (anche \(...\), \[...\]), resa da KaTeX; le equazioni lunghe vanno a capo in corrispondenza degli operatori o si riducono automaticamente.
• Evidenziazione del codice: linguaggio rilevato automaticamente; i documenti grandi vengono evidenziati in modalità lazy in base all'area visibile per rimanere fluidi.
• Diagrammi Mermaid: un blocco ```mermaid viene reso come flowchart / sequence / class / state / Gantt / pie, ecc.; clicca su un diagramma per aprire una finestra di visualizzazione autonoma (zoom / pan / schermo intero) che si aggiorna in tempo reale mentre modifichi.
• Immagini: incolla / trascina / scegli — salvate in una cartella <nomefile>_images/ accanto al documento con un riferimento relativo pulito (niente base64 in linea); le bozze usano una cartella temporanea migrata al salvataggio; «Salva come» appiattisce le immagini nella destinazione; centrate per impostazione predefinita.
• Zoom dei caratteri: ingrandisci i caratteri dell'editor e dell'anteprima indipendentemente (controlli −/percentuale/+, o ⌘/Ctrl + =/−/0); persiste tra i riavvii.
• Tabelle: tabelle GFM; le tabelle strette sono centrate rispetto al contenuto, quelle larghe scorrono orizzontalmente senza tagli.
• Citazioni (BibTeX): sintassi [@key] / \cite{key}, stile numerico; in fondo viene generato un elenco Riferimenti, con salti bidirezionali tra [n] nel testo e la voce; supporta un blocco ```bibtex incorporato o un .bib caricato separatamente.
• Supporto HTML: apri file .html per la resa; converti tra HTML e Markdown.
• Tema / lingua: scuro / chiaro, 17 lingue dell'interfaccia (中文, English, Français, Deutsch, Русский, Italiano, 日本語, 한국어, Español, Português, العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл) — arabo e urdu automaticamente da destra a sinistra).
• Bozza automatica: il contenuto viene salvato periodicamente e ripristinato dopo una chiusura / crash imprevisto.
• Conteggio parole: la barra di stato mostra caratteri / righe / parole in tempo reale, più riga e colonna correnti.
• Trascina e rilascia: rilascia un file .md sulla finestra per aprirlo; rilascia un'immagine per inserirla.
• Esportazione: salva come Markdown / HTML / PDF (vettoriale) / LaTeX.
• Colore del testo: la paletta della barra avvolge la selezione in <span style="color:…">.
• Modifica assistita dall'IA: seleziona del testo e premi ⌘/Ctrl + J (o il pulsante della barra strumenti) per far sì che l'IA lo raffini, lo espanda o ne cambi il tono; funziona con servizi online (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi, ecc.) e con un modello locale come Ollama per un uso completamente offline; il risultato viene visualizzato in anteprima prima di sostituire l'originale, e la chiave API viene memorizzata solo localmente.
• Indietro / Avanti: cronologia unificata di documenti e posizioni del cursore; pulsanti ◀ ▶, Alt+←/→.
• Segui i link: un clic su un link nell'anteprima apre la destinazione in una nuova scheda (http nel browser di sistema); il documento corrente non viene sostituito.

📦 Installazione

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).

⌨️ Scorciatoie

Usa ⌘ su macOS, Ctrl su Windows / Linux.

Con più finestre aperte, le scorciatoie interessano solo la finestra in primo piano. Quando la finestra del visualizzatore di immagini è aperta, ⌘/Ctrl + =/−/0 ingrandisce l'immagine.

📝 Sintassi rapida

Markdown: intestazioni # / ## / ###, grassetto **testo**, corsivo *testo*, barrato ~~testo~~, codice inline `codice`, blocchi di codice (tre backtick, con linguaggio opzionale), citazione > testo, liste - / 1., lista attività - [ ] / - [x], collegamento [testo](url), immagine ![alt](url), divisore ---, tabelle | A | B |.

Matematica: inline $E = mc^2$; blocco $$\int_0^1 x\,dx$$ (può occupare più righe). Usa la sintassi LaTeX, resa da KaTeX; il $ all'interno dei blocchi di codice non è trattato come delimitatore matematico. Supporta align / aligned, matrici, cases e altri ambienti comuni.

Citazioni: scrivi [@key] o [@a; @b] nel testo (compatibile con LaTeX \cite{key}), incorpora la libreria tramite un blocco ```bibtex o carica un .bib con il pulsante "Refs". In fondo viene generato un elenco Riferimenti; [n] nel testo è cliccabile.

📤 Esportazione (Salva come)

Fai clic su "Salva come" e scegli un formato:

• Markdown (.md): salva il sorgente e aggiorna il nome / percorso della scheda corrente.
• HTML (.html): HTML autonomo con CSS inline + evidenziazione del codice; la matematica viene mantenuta come letterale $…$, resa automaticamente dal KaTeX inline.
• PDF vettoriale: finestra di stampa di sistema, output vettoriale, nitido a qualsiasi zoom. Scegli "Salva come PDF".
• LaTeX (.tex): convertito in sorgente .tex compilabile (con documentclass e pacchetti; matematica lasciata invariata). Esporta una copia.

🔒 Offline e sicurezza

• Zero richieste di rete a runtime. L'output di build dist/index.html viene auto-verificato: nessun collegamento esterno src= / href= / url() / @import.
• CSP rigorosa (solo IPC locale, nessuna WAN); tutti i file vengono letti/scritti localmente, nulla viene caricato.
• Verifica: disattiva il Wi-Fi / scollega il cavo e avvia — matematica, immagini, evidenziazione del codice e Mermaid funzionano tutti.
• dist/index.html mostra ancora circa una dozzina di stringhe https://github.com/…; queste si trovano tutte all'interno di commenti di licenza / sorgente di marked / highlight.js ecc. — testo semplice che non attiva mai alcuna richiesta; lasciati intatti per rispettare le licenze open-source.

🛠️ Compila dai sorgenti

Codice sorgente: https://github.com/fwzheng/mdex. Segui le istruzioni di build nel repository (setup, dipendenze e comandi sono documentati lì).

📁 Struttura del progetto

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

🎨 Personalizzazione

📄 Licenza

Il codice proprio del progetto è open source sotto Apache License 2.0.

Componenti di terze parti: il progetto utilizza alcuni componenti di terze parti (tra cui, ma non solo, marked, KaTeX, highlight.js, DOMPurify, jsPDF, html2canvas-pro, turndown, mermaid, @retorquere/bibtex-parser e Tauri, ecc.); i rispettivi avvisi su copyright e licenza sono dettagliati nei file sorgente. Tali componenti sono distribuiti rispettivamente sotto MIT, BSD-3-Clause, Apache-2.0, MPL-2.0 e altre licenze open source.

Requisiti di distribuzione: secondo la licenza Apache-2.0, ridistribuire questo progetto richiede di mantenere i file LICENSE e NOTICE; se modifichi un file sorgente, devi indicare chiaramente le modifiche nel file corrispondente.

📬 Contatti

Per problemi o suggerimenti: fw@spinss.cn