FAQ

Domande frequenti e soluzioni

Installazione e Requisiti

Quali sono i requisiti di sistema per MdExplorer?

Windows 10+ o Linux (Ubuntu 20.04+, Debian 10+, Fedora 35+). Per le funzionalità Git serve Git installato sul sistema. Per l'export PDF serve Pandoc e una distribuzione LaTeX (MiKTeX o TeX Live). Per l'export Word serve solo Pandoc.

Come installo MdExplorer su Windows?

Scarica il bootstrapper installer dalla pagina download (circa 3 MB). L'installer scaricherà automaticamente l'applicazione completa. Gli aggiornamenti successivi sono automatici.

Come installo MdExplorer su Linux?

Scarica il file AppImage dalla pagina download. Rendi il file eseguibile con chmod +x e avvialo. L'AppImage è autocontenuto e non richiede installazione.

Installation and Requirements

What are the system requirements for MdExplorer?

Windows 10+ or Linux (Ubuntu 20.04+, Debian 10+, Fedora 35+). Git features require Git installed on your system. PDF export requires Pandoc and a LaTeX distribution (MiKTeX or TeX Live). Word export requires only Pandoc.

How do I install MdExplorer on Windows?

Download the bootstrapper installer from the download page (approximately 3 MB). The installer will automatically download the full application. Subsequent updates are automatic.

How do I install MdExplorer on Linux?

Download the AppImage file from the download page. Make the file executable with chmod +x and run it. The AppImage is self-contained and requires no installation.

Configurazione

Come cambio il tema dell'editor?

Vai in Impostazioni (icona ingranaggio nella toolbar) e seleziona il tema desiderato. MdExplorer supporta tema chiaro e scuro.

Come configuro il server PlantUML?

Nelle impostazioni, sezione PlantUML, puoi specificare l'URL del server. Di default viene usato il server pubblico PlantUML. Per progetti privati, puoi installare un server PlantUML locale con Docker.

Configuration

How do I change the editor theme?

Go to Settings (gear icon in the toolbar) and select your desired theme. MdExplorer supports light and dark themes.

How do I configure the PlantUML server?

In the settings, PlantUML section, you can specify the server URL. By default, the public PlantUML server is used. For private projects, you can install a local PlantUML server with Docker.

Editor

Quali scorciatoie da tastiera sono disponibili?

Le principali: Ctrl+B (grassetto), Ctrl+I (corsivo), Ctrl+K (link), Ctrl+Shift+K (blocco codice), Ctrl+S (salva). La lista completa è disponibile nelle impostazioni.

Posso usare MdExplorer come editor di testo semplice?

Sì, MdExplorer può aprire e modificare qualsiasi file di testo, non solo file .md.

Come cerco testo nei file del progetto?

Usa Ctrl+Shift+F per la ricerca full-text in tutto il progetto. I risultati mostrano il file, la riga e un estratto del contesto.

Editor

What keyboard shortcuts are available?

The main ones: Ctrl+B (bold), Ctrl+I (italic), Ctrl+K (link), Ctrl+Shift+K (code block), Ctrl+S (save). The full list is available in the settings.

Can I use MdExplorer as a plain text editor?

Yes, MdExplorer can open and edit any text file, not just .md files.

How do I search for text across project files?

Use Ctrl+Shift+F for full-text search across the entire project. Results show the file, line number, and a context excerpt.

Git

Serve Git installato sul sistema?

Sì, MdExplorer usa l'installazione Git del sistema operativo. Installa Git da git-scm.com prima di usare le funzionalità Git di MdExplorer.

Come configuro un repository remoto?

Apri il pannello Git, usa la funzione "Add Remote" per configurare l'URL del repository remoto (GitHub, GitLab, Bitbucket, etc.). Per l'autenticazione SSH, configura le chiavi SSH a livello di sistema operativo.

Posso usare MdExplorer senza Git?

Sì, Git è opzionale. MdExplorer funziona perfettamente come editor markdown standalone. Le funzionalità Git sono aggiuntive.

Git

Does Git need to be installed on the system?

Yes, MdExplorer uses the operating system's Git installation. Install Git from git-scm.com before using MdExplorer's Git features.

How do I configure a remote repository?

Open the Git panel, use the "Add Remote" function to configure the remote repository URL (GitHub, GitLab, Bitbucket, etc.). For SSH authentication, configure SSH keys at the operating system level.

Can I use MdExplorer without Git?

Yes, Git is optional. MdExplorer works perfectly as a standalone markdown editor. Git features are additional.

Export

Serve Pandoc per l'export?

Sì, Pandoc è necessario per export PDF e Word. Installalo da pandoc.org. Per il PDF serve anche una distribuzione LaTeX (MiKTeX su Windows, TeX Live su Linux).

Posso personalizzare i template di export?

Sì, i template si trovano nella cartella .md/templates/ del progetto. Puoi modificare il template LaTeX per il PDF o il reference.docx per il Word.

Export

Is Pandoc required for export?

Yes, Pandoc is required for PDF and Word export. Install it from pandoc.org. For PDF, you also need a LaTeX distribution (MiKTeX on Windows, TeX Live on Linux).

Can I customize the export templates?

Yes, templates are located in the .md/templates/ folder of your project. You can modify the LaTeX template for PDF or the reference.docx for Word.

Troubleshooting

L'export PDF non funziona, cosa faccio?

Verifica che Pandoc sia installato e nel PATH (esegui pandoc --version nel terminale). Verifica che sia installata una distribuzione LaTeX. Controlla che il file YAML front matter sia sintatticamente corretto.

Il pannello Git mostra un errore.

Verifica che Git sia installato e nel PATH (esegui git --version nel terminale). Verifica che la cartella del progetto sia inizializzata come repository Git (esegui git init se necessario).

I diagrammi PlantUML non si renderizzano.

Verifica la connessione internet (il server PlantUML di default è remoto). Se usi un server PlantUML locale, verifica che sia in esecuzione. Controlla la sintassi PlantUML nel blocco codice.

Troubleshooting

PDF export is not working, what do I do?

Verify that Pandoc is installed and in your PATH (run pandoc --version in the terminal). Verify that a LaTeX distribution is installed. Check that the YAML front matter is syntactically correct.

The Git panel shows an error.

Verify that Git is installed and in your PATH (run git --version in the terminal). Verify that the project folder is initialized as a Git repository (run git init if needed).

PlantUML diagrams are not rendering.

Check your internet connection (the default PlantUML server is remote). If you are using a local PlantUML server, verify that it is running. Check the PlantUML syntax in the code block.