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

MDeX · se pronuncia "em-dex" (/ˌemˈdɛks/) — la letra M seguida de "dex", dos sílabas.

Un lector y editor de Markdown multilingüe centrado en la privacidad y la asistencia con IA. Cada archivo se procesa localmente — sin red, sin subidas, sin sincronización en la nube, sin anuncios, sin telemetría por defecto; el guardado atómico (a prueba de fallos) evita la pérdida de datos ante cuelgues o cortes de energía. Desde v2.0, MDeX también ofrece edición asistida por IA opcional — y puede seguir siendo totalmente offline: un modelo local (p. ej., Ollama) no necesita internet; solo un servicio de IA en línea (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi, etc.) realiza una petición, y únicamente cuando lo configuras y lo activas.

• Un único frontend HTML autónomo (sin Vue / React); Tauri v2 proporciona únicamente el shell nativo (ventanas, menús, diálogos de archivos).
• Cero peticiones de red en tiempo de ejecución: marked / KaTeX / highlight.js / DOMPurify / mermaid / jsPDF / html2canvas-pro / turndown / @retorquere/bibtex-parser y todas las fuentes woff2 de KaTeX están incrustadas / embebidas en base64 dentro de un único index.html.
• Admite .md / .markdown / .html; puede configurarse como el manejador predeterminado de .md — doble clic para abrir.

🌐 Idiomas

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

• Cambia en cualquier momento desde el menú de idioma de la barra de herramientas; tu elección se recuerda entre sesiones.
• El árabe se renderiza de derecha a izquierda (RTL) automáticamente — el texto del cuerpo, los encabezados, los marcadores de lista y toda la barra de herramientas se reflejan hacia la derecha; los bloques de código incrustados, las fórmulas matemáticas en LaTeX, los términos en inglés y los números de versión permanecen de izquierda a derecha, sin reflejarse nunca.
• Este README está traducido a los 17 idiomas — usa el selector en la parte superior de esta página.

✨ Características

• Multi-pestaña + multi-ventana: abre varios archivos a la vez; los cambios sin guardar se marcan con un punto, y se te pregunta antes de cerrar; clic central en una pestaña para cerrarla. Un doble clic en un .md abre su propia ventana (un archivo por ventana); un doble clic en un archivo ya abierto enfoca esa ventana en lugar de volver a abrirla.
• Vista previa dividida en vivo: arrastra el divisor para cambiar el tamaño; el botón de la barra de herramientas alterna entre Dividido / Editor / Vista previa.
• Clic para posicionar: haz clic en el editor para desplazar la vista previa; haz clic en la vista previa para saltar con el cursor en el editor.
• Buscar y reemplazar: encontrar, reemplazar uno o todos, con conteo de coincidencias.
• Matemáticas: en línea $…$ y en bloque $$…$$ (también \(...\), \[...\]), renderizadas por KaTeX; las ecuaciones largas se ajustan en los operadores o se reducen automáticamente.
• Resaltado de código: el lenguaje se autodetecta; los documentos grandes se resaltan de forma perezosa según el viewport para mantener la fluidez.
• Diagramas Mermaid: un bloque ```mermaid se renderiza como diagrama de flujo / secuencia / clases / estados / Gantt / circular, etc.; haz clic en un diagrama para abrir una ventana de visualización independiente (zoom / pan / pantalla completa) que se actualiza en vivo mientras editas.
• Imágenes: pegar / soltar / elegir — guardadas en una carpeta <nombrearchivo>_images/ junto al documento con una referencia relativa limpia (sin base64 en línea); los borradores usan una carpeta temporal migrada al guardar; «Guardar como» aplana las imágenes hacia el destino; centradas por defecto.
• Zoom de fuente: amplía las fuentes del editor y la vista previa de forma independiente (controles −/porcentaje/+, o ⌘/Ctrl + =/−/0); persiste entre reinicios.
• Tablas: tablas GFM; las tablas estrechas se centran al contenido, las anchas se desplazan horizontalmente sin recortes.
• Citas (BibTeX): sintaxis [@key] / \cite{key}, estilo numérico; se genera una lista de Referencias al final, con saltos bidireccionales entre la [n] en el texto y la entrada; admite un bloque ```bibtex incrustado o un .bib cargado por separado.
• Soporte HTML: abre archivos .html para renderizarlos; convierte entre HTML y Markdown.
• Tema / idioma: oscuro / claro, 17 idiomas de interfaz (中文, English, Français, Deutsch, Русский, Italiano, 日本語, 한국어, Español, Português, العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл) — el árabe y el urdu se autoajustan de derecha a izquierda).
• Borrador automático: el contenido se guarda periódicamente y se restaura tras un cierre / fallo inesperado.
• Conteo de palabras: la barra de estado muestra caracteres / líneas / palabras en vivo, más la fila y columna actuales.
• Arrastrar y soltar: suelta un archivo .md sobre la ventana para abrirlo; suelta una imagen para insertarla.
• Exportación: guardar como Markdown / HTML / PDF (vectorial) / LaTeX.
• Color del texto: la paleta de la barra envuelve la selección en <span style="color:…">.
• Edición asistida por IA: selecciona un texto y pulsa ⌘/Ctrl + J (o el botón de la barra de herramientas) para que la IA lo refine, lo expanda o le cambie el tono; funciona con servicios en línea (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi, etc.) y con un modelo local como Ollama para uso totalmente sin conexión; el resultado se previsualiza antes de reemplazar el original, y la clave de API se almacena solo localmente.
• Atrás / Adelante: historial unificado de documentos y posiciones del cursor; botones ◀ ▶, Alt+←/→.
• Seguir enlaces: un clic en un enlace de la vista previa abre el destino en una nueva pestaña (http en el navegador del sistema); el documento actual no se reemplaza.

📦 Instalación

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

⌨️ Atajos

Usa ⌘ en macOS, Ctrl en Windows / Linux.

Con varias ventanas abiertas, los atajos solo afectan a la ventana enfocada. Cuando la ventana del visor de imágenes está abierta, ⌘/Ctrl + =/−/0 amplía la imagen en su lugar.

📝 Hoja de referencia rápida

Markdown: encabezados # / ## / ###, negrita **texto**, cursiva *texto*, tachado ~~texto~~, código en línea `código`, bloques de código (triple comilla invertida, con lenguaje opcional), cita > texto, listas - / 1., lista de tareas - [ ] / - [x], enlace [texto](url), imagen ![alt](url), divisor ---, tablas | A | B |.

Matemáticas: en línea $E = mc^2$; en bloque $$\int_0^1 x\,dx$$ (puede ocupar varias líneas). Usa sintaxis LaTeX, renderizada por KaTeX; el $ dentro de bloques de código no se trata como delimitador matemático. Admite align / aligned, matrices, cases y otros entornos comunes.

Citas: escribe [@key] o [@a; @b] en el texto (compatible con LaTeX \cite{key}), incrusta la biblioteca mediante un bloque ```bibtex o carga un .bib con el botón "Refs". Se genera una lista de Referencias al final; la [n] en el texto es clicable.

📤 Exportación (Guardar como)

Haz clic en "Guardar como" y elige un formato:

• Markdown (.md): guarda el código fuente y actualiza el nombre / ruta de la pestaña actual.
• HTML (.html): HTML autónomo con CSS incrustado + resaltado de código; las fórmulas se mantienen como literales $…$, auto-renderizadas por KaTeX incrustado.
• PDF vectorial: diálogo de impresión del sistema, salida vectorial, nítido en cualquier nivel de zoom. Elige "Guardar como PDF".
• LaTeX (.tex): convertido a un código fuente .tex compilable (con documentclass y paquetes; las fórmulas se mantienen tal cual). Exporta una copia.

🔒 Offline y seguridad

• Cero peticiones de red en tiempo de ejecución. La salida de compilación dist/index.html se auto-verifica: sin enlaces externos src= / href= / url() / @import.
• CSP estricta (solo IPC local, sin WAN); todos los archivos se leen / escriben localmente, nada se sube.
• Verificación: apaga el Wi-Fi / desconecta el cable y ejecuta la app — las matemáticas, imágenes, resaltado de código y Mermaid siguen funcionando.
• dist/index.html todavía muestra algo menos de una docena de cadenas https://github.com/…; todas viven dentro de comentarios de licencia / código fuente de marked / highlight.js etc. — texto plano que nunca dispara una petición; se dejan intactas para respetar las licencias de código abierto.

🛠️ Compilar desde el código fuente

Código fuente: https://github.com/fwzheng/mdex. Sigue las instrucciones de compilación del repositorio (configuración, dependencias y comandos documentados allí).

📁 Estructura del proyecto

markdown/
├── app-shell.html          # shell del frontend (HTML+CSS); la lógica de la app está en src/app.js
├── src/
│   ├── app.js              # lógica de la aplicación (// @ts-check; integrada en dist por 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        # declaraciones de tipos vendor / Window para verificación de tipos
├── tsconfig.json           # config de verificación de tipos (tsc --noEmit; sin bundler)
├── tools/
│   ├── fetch-vendor.mjs    # una vez: descarga dependencias en vendor/ + bloqueo de integridad (solo aquí en línea)
│   ├── build-html.mjs      # incrusta vendor + src/app.js + i18n.js + help.js en dist/index.html (fuentes KaTeX → base64)
│   └── test-pure.mjs       # tests de funciones puras del frontend (npm test)
├── dist/index.html         # salida de compilación: archivo único independiente (Tauri frontendDist)
├── vendor/                 # caché de descargas + 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     # ventana 1200×750, CSP estricta, iconos, asociación .md, hooks de menú
    ├── capabilities/default.json
    ├── icons/              # conjunto completo de iconos desde `cargo tauri icon`
    └── src/{main.rs, lib.rs}   # menús + E/S de archivos + enrutamiento multi-ventana + escritura atómica / propiedad de archivos

🎨 Personalización

📄 Licencia

El código propio de este proyecto es de código abierto bajo Apache License 2.0.

Componentes de terceros: el proyecto utiliza algunos componentes de terceros (incluidos, entre otros, marked, KaTeX, highlight.js, DOMPurify, jsPDF, html2canvas-pro, turndown, mermaid, @retorquere/bibtex-parser y Tauri, etc.); sus avisos de copyright y licencia se detallan en los archivos fuente respectivos. Dichos componentes se distribuyen bajo las licencias MIT, BSD-3-Clause, Apache-2.0, MPL-2.0 y otras de código abierto.

Requisitos de distribución: según la licencia Apache-2.0, redistribuir este proyecto exige conservar los archivos LICENSE y NOTICE; si modifica algún archivo fuente, debe indicar claramente los cambios en el archivo correspondiente.

📬 Contacto

Para problemas o sugerencias: fw@spinss.cn