in develop

mdeditor

mdeditor is een lichtgewicht webgebaseerde editor voor Markdown bestanden, geschreven in Rust. Het draait als een lokale dienst en is bereikbaar via de browser. Het is ontworpen als beheertool voor mdserver, maar werkt met elke map vol Markdown bestanden.

Beschikbaar op gitlab

kijk op https://gitlab.com/dexter1-dev/mdweditor

Wat het doet

Via de browser bewerk je Markdown bestanden die op de server staan. Aan de linkerkant zie je een bestandsboom met alle bestanden en mappen in de geconfigureerde map. Klik op een bestand om het te openen in de editor. Wijzigingen sla je op met de knop of met Ctrl+S.

Opmaakwerkbalk

Boven de editor staat een werkbalk met knoppen voor gangbare Markdown opmaak:

  • koppen (H1, H2, H3)
  • vet, cursief, doorhalen
  • inline code en codeblokken
  • links en afbeeldingen
  • opsommingen, genummerde lijsten en citaten
  • tabel en taaklist
  • horizontale lijn
  • speciale tekens via de Ω knop

Selecteer tekst en klik een knop om de opmaak toe te passen. Klik nogmaals om de opmaak te verwijderen.

Frontmatter

Bevat een Markdown bestand een YAML frontmatter blok (tussen --- regels), dan toont mdeditor de velden date, category en tags in een balk boven de editor. Je kunt die velden direct aanpassen zonder in de broncode te hoeven typen.

Bestanden en mappen beheren

Vanuit de bestandsboom kun je:

  • een map in of uitklappen door erop te klikken
  • een bestand openen voor bewerking
  • een bestand of lege map verwijderen (na bevestiging)
  • een bestand of map hernoemen
  • een geselecteerde map gebruiken als startpunt voor een nieuw bestand

Via de knop + Nieuw maak je een nieuw Markdown bestand aan met een kant en klaar frontmatter sjabloon, of een nieuwe map.

Configuratie

mdeditor leest zijn instellingen uit ~/.config/mdeditor/mde.conf:

bind = 192.168.1.4
port = 3001
dir  = /pad/naar/bestanden

De server bindt standaard aan het lokale netwerk en is niet via internet bereikbaar.

Technisch

mdeditor is gebouwd met Rust en Axum. De volledige webinterface zit ingebakken in de binary, er zijn geen externe bestanden of afhankelijkheden nodig. De editor draait als een systemd gebruikersdienst en start automatisch bij inloggen.

markdowneditorrustwebinterface