Übersicht

Wiki-bl ist ein persönliches Wissenssystem für Windows. Alle Inhalte werden lokal gespeichert – keine Cloud, keine Registrierung, keine Abhängigkeiten vom Internet.

Die Anwendung basiert auf Markdown als Textformat: Sie schreiben im Editor auf der linken Seite, die formatierte Vorschau erscheint rechts in Echtzeit.

Hauptfunktionen

• Unbegrenzt viele Seiten in einer SQLite-Datenbank
• Ordner-Hierarchie mit Drag & Drop
• Markdown-Editor mit Syntaxhervorhebung und Live-Vorschau
• Klickbare [[WikiLinks]] zwischen Seiten
• Backlinks: alle verlinkenden Seiten auf Knopfdruck anzeigen
• Volltextsuche über Titel, Inhalt und Tags
• Fünf Seitenvorlagen (Meeting, TODO, Notiz, Code-Snippet)
• Export einer Seite als HTML, PDF oder Markdown
• Neu v3.8: Alle Seiten auf einmal als ZIP exportieren
• ZIP-Backup aller Seiten und Ordner
• Autosave im einstellbaren Intervall
• Neu v3.8: [[]] WikiLink-Button – durchsuchbare Seitenliste zum schnellen Einfügen von [[Seitenname]]
• Neu v3.8: Tab-Begrenzung (konfigurierbar, Standard 12)
• Neu v3.8: Unterstreichen via <u>text</u>
• Neu v3.8: Bilder und SVG direkt einbetten (Base64)
• Hell- und Dunkel-Theme
• Seiten umbenennen, verschieben, löschen
• Neu v3.22: Ordner umbenennen (F2 oder Rechtsklick → Umbenennen)
• Neu v3.23: Ordner importieren durchsucht Unterordner (rekursiv statt nur oberste Ebene)
• Neu v3.23: Speicherort ändern übernimmt eine am Zielort bereits vorhandene Struktur, statt sie zu überschreiben
• Neu v3.24: Kleinere EXE – ungenutzte Qt-Module und WebEngine-Sprachdateien werden beim Build ausgeschlossen
• Neu v3.25: Import von Word (.docx), HTML, RTF und CSV – nicht mehr nur .md und .txt
• Neu v3.25: Word- und HTML-Tabellen werden beim Import zu echten Markdown-Tabellen
• Neu v3.27: Große Bilder werden beim Einbetten automatisch verkleinert – ein Kamerafoto ließ die Vorschau bis v3.26 weiß bleiben
• Neu v3.27: Eingebettete Bilder erscheinen jetzt auch im Ausdruck und im PDF-Export
• Neu v3.26: Lesemodus als Standard – Seiten öffnen zunächst nur mit der Vorschau, Bearbeiten ist ein bewusster Klick
• Neu v3.26: Splitter drehbar (F8) und Seitenbaum ein-/ausblendbar (F10)
• Neu v3.26: Sichtbare Rückgängig/Wiederholen-Knöpfe (↶ ↷) im Editor

Speicherort der Wiki-Daten

Standardmäßig werden alle Wiki-Daten im Unterordner data\ neben der Programmdatei gespeichert. Der Speicherort kann in den Einstellungen geändert werden – zum Beispiel auf einen Netzlaufwerk, ein USB-Laufwerk oder einen Cloud-Sync-Ordner (OneDrive, Dropbox).

Speicherort ändern

1. Einstellungen → Einstellungen … öffnen.
2. Abschnitt Speicherort der Wiki-Daten – der aktuelle Pfad wird angezeigt.
3. Klick auf „Ordner wählen …" → Ordner auswählen → OK.
4. Das Programm verschiebt alle vorhandenen Daten automatisch in den neuen Ordner und startet neu.

Vorhandene Struktur am Zielort NEU v3.23

Enthält der neu gewählte Ordner bereits eigene .md- oder .txt-Dateien – zum Beispiel ein fremdes Markdown-Vault oder ein früheres Wiki-bl-Datenverzeichnis –, liest Wiki-bl diese Struktur (inklusive Unterordner) beim Wechsel vollständig ins aktuelle Wiki ein, bevor irgendetwas kopiert wird. Seiten, deren Titel bereits existiert, werden übersprungen statt überschrieben.

Standard wiederherstellen

Klick auf „Standard wiederherstellen" – die Daten werden zurück in den data\-Ordner neben der EXE verschoben.

Technischer Hintergrund

Der gewählte Pfad wird in der Datei wiki_data_path.cfg neben der EXE gespeichert. Fehlt diese Datei, wird automatisch der Standardpfad verwendet.

Installation & Start

Empfohlen: die EXE-Version

Wiki-bl wird als fertige Windows-Anwendung gebaut und soll auch so benutzt werden. Nach dem Build (siehe Kapitel EXE erstellen) liegt sie hier:

dist\Wiki-bl\Wiki-bl_v3.27.exe

Ein Doppelklick genügt. Warum diese Version die primäre ist:

• Kein Python nötig. Die EXE bringt alles mit – Python, PyQt6, die Chromium-Vorschau, die Markdown-Bibliothek. Auf einem Rechner ohne Python-Installation läuft nur diese Variante.
• Keine Versionskonflikte. Ein Python-Update oder ein anderes Programm, das eine andere PyQt6-Version installiert, kann die Skript-Variante lahmlegen. Die EXE ist davon unberührt, weil sie ihre eigenen Bibliotheken danebenliegen hat.
• Portabel. Der gesamte Ordner dist\Wiki-bl lässt sich auf einen USB-Stick oder in einen Sync-Ordner kopieren und läuft dort weiter – die Wiki-Daten im Unterordner data\ ziehen mit um.
• Nichts flackert auf. Kein Konsolenfenster, eigenes Symbol in Taskleiste und Explorer, Autostart-Eintrag möglich.

Alternative für Entwicklung: als Python-Skript

Voraussetzung: Python 3.10 oder neuer ist installiert.

1. ZIP entpacken, alle Dateien in einen Ordner legen.
2. Einmalig die benötigten Pakete installieren:

pip install PyQt6 PyQt6-WebEngine markdown

3. Programm starten:

python wiki_bl_v3_26.py

Direktstart per Doppelklick ohne Konsolenfenster NEU v3.13

Statt die Konsole/Eingabeaufforderung zu benutzen, liegt im Paket die Datei wiki_bl_v3_26.pyw. Ein Doppelklick darauf startet das Programm direkt über pythonw.exe – ohne schwarzes Konsolenfenster, genauso bequem wie eine fertige EXE, nur eben mit Python im Hintergrund.

Die EXE selbst bauen (PyInstaller)

So entsteht die oben empfohlene EXE-Version:

1. Stellen Sie sicher, dass wiki_bl_v3_26.py, wiki_bl_v3_26.spec, wiki.ico und build_wiki_bl_v3_26.bat im selben Ordner liegen.
2. Doppelklick auf build_wiki_bl_v3_26.bat.
3. Warten bis „FERTIG!" erscheint.
4. Die fertige Anwendung liegt in: dist\Wiki-bl\Wiki-bl_v3.27.exe

Wo werden die Daten gespeichert?

Die Wiki-Daten (Datenbank und Markdown-Dateien) liegen im Unterordner data\ neben der EXE bzw. neben dem Python-Skript. Dieser Ordner wird beim ersten Start automatisch angelegt.

Benutzeroberfläche

Aufbau

• Linke Leiste (Seitenbaum): zeigt alle Ordner und Seiten. Einzelklick öffnet eine Seite. Rechtsklick öffnet das Kontextmenü.
• Tabs (rechts oben): mehrere Seiten können gleichzeitig geöffnet sein. Ein * im Tab-Titel zeigt ungespeicherte Änderungen an. Das Tab-Limit ist einstellbar (Standard: 12).
• Editor (links im Tab): hier wird der Markdown-Text geschrieben.
• Vorschau (rechts im Tab): zeigt die formatierte Ausgabe in Echtzeit.
• Toolbar im Tab: NEU v3.26 es gibt jetzt zwei Toolbars, je nach Ansichtsmodus (siehe Kapitel „Lesen & Bearbeiten"). Im Bearbeiten-Modus: Rückgängig/Wiederholen (↶ ↷), Fett, Kursiv, Durchstrich, Unterstreichen, Überschriften H1–H6, Inline-Code, Code-Block, Trennlinie, Aufgabe, Link, Bild einbetten, [[]] WikiLink einfügen (durchsuchbare Seitenliste, neu v3.8), 🔙 Backlinks anzeigen und Tags. Im Lesemodus: nur der Knopf ✏ Bearbeiten, Tags und Backlinks.
• Statusleiste (unten): zeigt Meldungen und die aktuelle Wortzahl.

Menüleiste

• Datei: Neue Seite, Ordner, Vorlagen, Speichern, Backup, Export (einzeln + alle), Zuletzt geöffnet, Beenden.
• Bearbeiten: Rückgängig, Wiederholen, Ausschneiden, Kopieren, Einfügen, Suchen & Ersetzen, Wiki-Suche.
• Seite: Eigenschaften, Umbenennen, Löschen, Backlinks, Favorit, Tags vorschlagen, Drucken.
• Ansicht: NEU v3.26 Lesen / Geteilt / Nur Editor, Editor & Vorschau nebeneinander↔untereinander (F8), Seitenbaum ein-/ausblenden (F10), Dark Mode umschalten, Seitenbaum sortieren.
• Einstellungen: Speicherort, Autostart, Infobereich (Systray), Schriftart, Theme, Autosave, Tab-Limit, Link-Verhalten.
• Hilfe: Handbuch, Über Wiki-bl.

Lesen & Bearbeiten NEU v3.26

Ein Wiki wird überwiegend gelesen – nachgeschlagen, nicht geschrieben. Deshalb öffnen Seiten ab v3.26 zunächst im Lesemodus: nur die Vorschau, volle Breite, eine schlanke Leiste statt 14 Formatierungsknöpfen. Bearbeiten ist eine bewusste Zusatzhandlung.

Die drei Ansichtsmodi

• Lesen (Standard): nur die Vorschau. Statt der vollen Werkzeugleiste erscheint nur der Knopf ✏ Bearbeiten (F9) sowie Tags und Backlinks.
• Geteilt: Editor und Vorschau nebeneinander (bzw. untereinander, siehe unten) – das bisherige Verhalten von Wiki-bl bis v3.25.
• Nur Editor: nur der Editor, keine Vorschau – für längeres Tippen ohne Ablenkung.

Umschalten

• F9 oder der Knopf ✏ Bearbeiten/👁 Lesen wechseln zwischen Lesen und Geteilt hin und her.
• Doppelklick irgendwo in der Vorschau wechselt ebenfalls in den Bearbeiten-Modus.
• Über das Menü Ansicht lassen sich alle drei Modi einzeln auswählen, auch Nur Editor.

Splitter drehen NEU v3.26

F8 (oder Ansicht → Editor und Vorschau untereinander) dreht die Aufteilung von Editor und Vorschau zwischen nebeneinander und untereinander um – für schmalere Fenster oder Hochformat-Bildschirme. Wirkt auf alle offenen Tabs gleichzeitig und wird für neu geöffnete Tabs gemerkt.

Seitenbaum ein-/ausblenden NEU v3.26

F10 (oder Ansicht → Seitenbaum ein-/ausblenden) blendet die linke Leiste aus – schafft zusätzlich Platz, besonders im Lesemodus.

Rückfallebene: immer zum Bearbeiten öffnen

Wer weiterhin sofort im Editor landen möchte, findet unter Einstellungen → Verhalten die Option „Seiten immer zum Bearbeiten öffnen". Ist sie aktiv, öffnen Seiten wie bis v3.25 direkt im Modus Geteilt.

Seiten erstellen & bearbeiten

Neue Seite anlegen

Über Datei → Neue Seite, den Button + Neu in der Toolbar, oder Ctrl+N. Sie werden nach einem Titel gefragt. Der Titel muss eindeutig sein. Die neue Seite öffnet im Modus Geteilt (siehe Kapitel „Lesen & Bearbeiten").

Seite öffnen

Einzelklick auf eine Seite im Seitenbaum öffnet sie als neuen Tab – standardmäßig im Lesemodus (siehe oben). Bereits geöffnete Seiten werden aktiviert, nicht doppelt geöffnet. Wird das Tab-Limit erreicht, schließt das Programm automatisch den ältesten unveränderten Tab.

Seite speichern

Ctrl+S speichert die aktive Seite. Ctrl+Alt+S speichert alle geänderten Tabs auf einmal. Ein * im Tab-Titel zeigt ungespeicherte Änderungen an.

Seite umbenennen

Seite im Baum markieren, dann Seite → Umbenennen oder F2. Der neue Titel darf nicht bereits vergeben sein. Die zugehörige .md-Datei wird automatisch mitumbenannt.

Seite löschen

Seite im Baum markieren, dann Seite → Löschen oder Rechtsklick → Löschen. Eine Sicherheitsabfrage erscheint. Seit v3.18 wird dabei auch die zugehörige .md-Datei im pages-Ordner entfernt – bis v3.17 blieb sie als Karteileiche liegen.

Seite verschieben

Seiten können per Drag & Drop in einen anderen Ordner gezogen werden. Ungespeicherte Änderungen werden dabei automatisch gesichert.

Ordner & Struktur

Ordner dienen zur thematischen Gliederung. Sie können beliebig tief verschachtelt werden.

Neuen Ordner anlegen

Über Datei → Neuer Ordner, den Button Ordner in der Toolbar, oder Rechtsklick im Baum → Unterordner.

Regeln für Ordnernamen NEU v3.20

Ordnernamen müssen im ganzen Wiki eindeutig sein – auch dann, wenn die Ordner an ganz verschiedenen Stellen liegen. Es kann also nicht gleichzeitig Arbeit\Notizen und Privat\Notizen geben. Ebenfalls abgelehnt werden:

• der Name „Wiki“ – so heißt die Wurzel des Baums
• der Name „root“ – der interne Schlüssel der Wurzel
• ein Name, den es (auch in anderer Groß-/Kleinschreibung) schon gibt

Bei einem unzulässigen Namen bleibt der Dialog offen und der Name lässt sich direkt korrigieren.

Ordner umbenennen NEU v3.22

Ordner im Baum markieren, dann F2 drücken – oder Rechtsklick auf den Ordner → Umbenennen. Der neue Name muss den oben genannten Regeln für Ordnernamen genügen; eine reine Änderung der Groß-/Kleinschreibung (z. B. kochen → Kochen) ist erlaubt.

Beim Umbenennen ziehen automatisch mit:

• alle Seiten im Ordner (sie bleiben, wo sie sind – nur der Ordnername ändert sich),
• alle Unterordner samt Inhalt,
• geöffnete Tabs von Seiten aus diesem Ordner (Speichern landet weiter am richtigen Ort),
• das zugehörige Verzeichnis im Dateispiegel unter data\pages\ – das alte, leere Verzeichnis wird abgeräumt.

Ordner löschen

Rechtsklick auf den Ordner → Löschen. Bei Ordnern mit Inhalt erscheint eine Auswahl:

• Inhalt nach oben verschieben: Alle Seiten und Unterordner werden an den übergeordneten Ordner angehängt.
• Alles mitlöschen: Ordner und alle Seiten werden unwiderruflich gelöscht.

Ordner verschieben

Ordner können per Drag & Drop in andere Ordner verschoben werden. Der komplette Teilbaum (Unterordner und Seiten) wandert mit – auch im Dateisystem.

Markdown-Formatierung

Der Editor unterstützt Standard-Markdown mit den Erweiterungen extra, codehilite, toc und nl2br.

Grundlegende Formatierungen

Links und Bilder

[Anzeigetext](https://beispiel.de)
![Bildbeschreibung](pfad/zum/bild.jpg)

Links können über den 🔗-Button eingefügt werden. Bilder werden ab v3.8 direkt eingebettet (Base64) – kein externer Pfad nötig.

Code-Blöcke

```python
def hallo():
    print("Hallo Welt")
```

Tabellen

| Spalte 1 | Spalte 2 |
|----------|----------|
| Wert A   | Wert B   |

Tabelle bequem einfügen NEU v3.21

Statt die Pipe-Syntax von Hand zu tippen, öffnet der Button ⊞ Tabelle in der Editor-Toolbar einen Dialog. Dort wählen Sie:

• Spalten und Datenzeilen (die Kopfzeile kommt automatisch oben drauf)
• Ausrichtung je Spalte: links, zentriert oder rechts
• optional Kopfzeile einfärben (Hintergrund- und Textfarbe aus einer festen Palette)
• optional Zebrastreifen – jede zweite Datenzeile bekommt eine Hintergrundfarbe

Die fertige Tabelle wird an der Cursorposition eingefügt; die Zellen sind leer und werden anschließend im Editor ausgefüllt.

Markdown oder HTML? NEU v3.21

Toolbar-Buttons im Editor

Die Toolbar über dem Editor bietet Schnellzugriff: Fett, Kursiv, Durchstrich, Unterstreichen, Überschriften H1–H6, Inline-Code, Code-Block, Trennlinie, Aufgabe, ⊞ Tabelle einfügen (neu v3.21), Link, Bild einbetten (Base64), [[]] WikiLink einfügen (Seitenliste mit Suchfeld, neu v3.8), 🔙 Backlinks anzeigen und Tags.

Unterstreichen NEU v3.8

Syntax

<u>unterstrichener Text</u>

Per Toolbar-Button

Klick auf den U̲-Button in der Editor-Toolbar. Markierten Text wählen, dann klicken – die Tags werden automatisch um die Auswahl gesetzt. Ohne Auswahl werden die Tags eingefügt und der Cursor zwischen sie gesetzt.

Im Editor

Die <u>…</u>-Tags werden im Editor blau und unterstrichen hervorgehoben, sodass unterstrichene Passagen auch beim Schreiben sofort erkennbar sind.

Bilder & Grafiken NEU v3.8

Bild einbetten

1. Klick auf den 🖼-Button in der Tab-Toolbar.
2. Bilddatei auswählen (PNG, JPG, GIF, WebP, BMP oder SVG).
3. NEU v3.27 Ist das Bild zu groß, wird es ohne Rückfrage automatisch verkleinert (siehe nächster Abschnitt). Die Statusleiste meldet, was geschehen ist – zum Beispiel „Bild verkleinert: 4032×3024 → 1200×900, 3,8 MB → 210 KB".
4. Das Bild wird als Base64-Data-URI in den Markdown-Text eingefügt und sofort in der Vorschau angezeigt.

Automatisches Verkleinern NEU v3.27

Warum das nötig war: Die Vorschau übergibt die fertige Seite an die eingebaute Chromium-Anzeige, und diese lädt eine Seite nur bis 2 MB. Darüber blieb die Vorschau bis v3.26 einfach weiß – ohne Fehlermeldung. Ein Kamerafoto (JPG, 3–6 MB) wächst als Base64 um rund ein Drittel und riss diese Grenze im Alleingang, während PNG-Screenshots (100–500 KB) immer funktionierten. Das sah aus wie „Wiki-bl kann kein JPG", war aber reine Größensache: kleine JPG ließen sich immer einbetten.

Wie gerechnet wird: Reicht die Verkleinerung auf 1200 px nicht aus, sinkt zuerst die Qualität (85 → 75), dann die Kantenlänge (900 → 700 → 500 px), bis das Bild in den verfügbaren Platz passt. Das Budget gilt je Seite, nicht je Bild: der bereits vorhandene Seiteninhalt zählt mit, sodass auch das fünfte Bild auf einer Seite noch angezeigt wird – dann eben stärker verkleinert. Wird es sehr eng, weist die Statusleiste darauf hin, dass ein Umbruch auf eine neue Seite besser wäre.

Wer das Original in voller Auflösung behalten will, legt es neben der EXE im Ordner data\images\ ab und verlinkt es (siehe „Hinweis zur Dateigröße" weiter unten) – verlinkte Bilder werden nicht angetastet.

Unterstützte Formate

Vektorgrafiken (SVG) NEU v3.8

SVG-Dateien (Scalable Vector Graphics) werden genauso eingebettet wie Rastergrafiken – als Base64 Data-URI. Vektorgrafiken haben entscheidende Vorteile:

• Beliebig skalierbar ohne Qualitätsverlust – ideal für Diagramme, Logos, technische Zeichnungen.
• Meist sehr kleine Dateigröße im Vergleich zu Rastergrafiken bei gleicher Darstellungsgröße.
• Erstellt z.B. mit Inkscape, draw.io, Figma oder direkt aus CAD-Software.

Hinweis zur Dateigröße

Eingebettete Bilder vergrößern den Seiteninhalt in der Datenbank. Für viele große Fotos empfiehlt sich statt Einbettung die Ablage im data\images\-Ordner neben der EXE und die Verlinkung per relativem Pfad:

![Beschreibung](images/mein-bild.jpg)

Bild-Lupe in der Vorschau NEU v3.14

1. Das 🔍-Symbol oben rechts in einem Bild anklicken, um die Lupe für dieses Bild zu aktivieren (Symbol färbt sich blau).
2. Maus über das Bild bewegen → es erscheint ein vergrößerter Ausschnitt (Standard ca. 2,5-fach) an der Mausposition.
3. Mausrad über dem Bild drehen, um die Zoomstufe zu verändern (1,5-fach bis 6-fach).
4. Maus vom Bild weg bewegen blendet die Lupe aus, sie bleibt aber aktiviert – erneutes Drüberfahren zeigt sie sofort wieder.
5. Erneuter Klick auf das 🔍-Symbol schaltet die Lupe für dieses Bild wieder aus.

WikiLinks

Mit [[Seitenname]] können Sie direkt auf andere Seiten im Wiki verlinken.

Weitere Infos: siehe [[Projektübersicht]]
Vgl. auch [[Meeting 2026-06-14]]

In der Vorschau werden WikiLinks als klickbare Links dargestellt. Ein Klick öffnet die verlinkte Seite direkt als neuen Tab.

WikiLink per Button einfügen NEU v3.8

Klick auf den [[]]-Button in der Tab-Toolbar öffnet eine durchsuchbare Liste aller gespeicherten Seiten:

• Im Suchfeld tippen, um die Liste zu filtern.
• Seite per Klick markieren oder Doppelklick → OK.
• [[Seitenname]] wird an der aktuellen Cursorposition eingefügt.

Externe Links im Browser öffnen NEU v3.9

Die Vorschau verwendet eine eingebettete Mini-Browser-Engine. Diese kann zwar Markdown-Inhalte, Tabellen und WikiLinks anzeigen, ist aber kein vollwertiger Browser: keine Erweiterungen, kein Download-Manager, keine Adressleiste, und manche Logins oder interaktive Webseiten funktionieren darin nicht zuverlässig.

Ab v3.9 öffnen normale Weblinks (http://, https://) sowie mailto:-Links daher standardmäßig im auf Ihrem System eingestellten Standard-Browser (z. B. Chrome, Edge, Firefox). Die Wiki-Vorschau selbst bleibt dabei unverändert auf der aktuellen Seite stehen.

Falls gewünscht, lässt sich dieses Verhalten in Einstellungen → Reiter „Verhalten" → Links in der Vorschau über die Checkbox „Externe Links im Standard-Browser öffnen" wieder abschalten; externe Links navigieren dann wieder innerhalb der eingebetteten Vorschau (altes Verhalten bis v3.8).

Vorlagen

Über Datei → Aus Vorlage … können neue Seiten mit vorgefertigter Struktur angelegt werden:

• Leere Seite: nur ein H1-Titel.
• Meeting-Notiz: Teilnehmer, Agenda, Ergebnisse, nächste Schritte.
• TODO-Liste: drei Prioritätsstufen mit Checkboxen.
• Notiz: Titel mit Datumszeile.
• Code-Snippet: Beschreibung, Code-Block, Verwendung.

Tags

Tags helfen beim Auffinden von Seiten zu bestimmten Themen. Sie werden kommagetrennt eingegeben.

Tags setzen: Klick auf den 🏷-Button in der Editor-Toolbar oder Seite → Tags vorschlagen. Die Wiki-Suche (Ctrl+F) durchsucht auch Tags.

Suchen & Ersetzen

Wiki-Suche (Ctrl+F)

Durchsucht alle gespeicherten Seiten gleichzeitig – nach Titel, Inhalt und Tags. Doppelklick auf ein Ergebnis öffnet die Seite.

Suchen & Ersetzen im Editor (Ctrl+H)

Sucht und ersetzt Text innerhalb der aktuell geöffneten Seite. Optionen: Groß/Klein, Ganzes Wort, Regex.

Speichern & Autosave

Manuell speichern

• Ctrl+S – aktive Seite speichern.
• Ctrl+Alt+S – alle geänderten Seiten speichern.
• Datei → Speichern unter … – als separate Datei.

Autosave

Unter Einstellungen → Einstellungen … (Reiter „Verhalten") kann Autosave aktiviert werden. Das Intervall ist in Minuten einstellbar (1–60). Alle geänderten Tabs werden automatisch gespeichert.

Beim Beenden

Beim Schließen mit ungespeicherten Änderungen erscheint eine Abfrage: Speichern, Verwerfen oder Abbrechen.

Dateiablage & Handy-Sync NEU v3.18

Jede gespeicherte Seite liegt zusätzlich zur Datenbank als ganz normale .md-Datei auf der Festplatte. Seit v3.18 bildet der Ordner data\pages\ dabei exakt den Seitenbaum ab, den Sie im Programm sehen – mit echten Unterordnern. Bis v3.17 lagen alle Dateien flach in einem einzigen Ordner.

Beispiel

Sieht der Seitenbaum so aus:

Wiki
 ├── Start
 ├── Kochen
 │    └── Rezepte
 │         └── Lasagne
 └── Arbeit
      └── Meeting

… dann liegt auf der Festplatte:

data\pages\Start.md
data\pages\Kochen\Rezepte\Lasagne.md
data\pages\Arbeit\Meeting.md

Wiki auf dem Handy lesen

Weil die Ablage jetzt eine gewöhnliche Ordnerstruktur mit Markdown-Dateien ist, lässt sich das Wiki auf jedes andere Gerät spiegeln:

1. Den Ordner data\pages\ (oder gleich den ganzen data-Ordner) mit einem Sync-Werkzeug abgleichen – z.B. Syncthing, OneDrive, Nextcloud oder Dropbox.
2. Auf dem Handy eine beliebige Markdown-App auf diesen Ordner zeigen lassen (z.B. Obsidian oder Markor unter Android).
3. Fertig – alle Seiten sind mit Ordnerstruktur lesbar, ohne dass Wiki-bl dort installiert sein muss.

Wichtig: die Datenbank ist maßgeblich

Verwaiste Dateien

Findet Wiki-bl beim Start eine .md-Datei im pages-Ordner, zu der es keine Seite in der Datenbank gibt, wird diese Datei nicht gelöscht, sondern nach data\pages_verwaist\ verschoben. So geht nichts verloren. Von dort lassen sich die Dateien bei Bedarf über Datei → Ordner importieren wieder ins Wiki holen.

Welche Dateien Wiki-bl einlesen kann NEU v3.25

Seit v3.25 versteht Wiki-bl acht Dateiendungen und wandelt sie beim Einlesen nach Markdown um. Bis v3.24 waren es nur .md und .txt.

Kopfblöcke aus dem Programm „Notizen" NEU v3.25

Das eingestellte Schwesterprogramm Notizen stellt jeder gespeicherten Datei einen Kopfblock voran:

---
title: Angebot Meier
tags: [kunde, offen, 2026]
modified: 2026-06-12T10:04:11
---

Wiki-bl trennt diesen Block beim Import ab und verwertet ihn: title wird zum Seitentitel (statt des Dateinamens), tags werden zu den Schlagwörtern der Seite. Ohne diese Behandlung stünde der Block als sichtbarer Text am Seitenanfang und die Schlagwörter wären verloren.

Ordner importieren erweitert v3.25

Datei → Ordner importieren liest alle oben genannten Dateiformate von der Festplatte ins Wiki ein. Seit v3.23 wird der gewählte Ordner rekursiv durchsucht: Jeder gefundene Unterordner wird als eigener Wiki-Ordner angelegt, und jede importierte Seite landet in genau dem Unterordner, in dem sie auf der Festplatte lag.

Gleiche Titel im selben Import-Lauf: Der Titel kann seit v3.25 auch aus <title> oder aus einem Notizen-Kopfblock stammen. Damit können zwei Dateien desselben Laufs denselben Titel liefern – etwa mehrere HTML-Exporte namens „Unbenanntes Dokument". Wiki-bl nummeriert dann durch: die zweite Seite heißt Unbenanntes Dokument (2). Es geht nichts verloren.

Sind zwei Unterordner an verschiedenen Stellen der Quellstruktur gleich benannt, hängt Wiki-bl automatisch eine Zählung an (z.B. Notizen (2)), weil Ordnernamen im Wiki insgesamt eindeutig sein müssen.

Einzelne Datei öffnen (Strg+O) erweitert v3.25

Datei → Öffnen versteht seit v3.25 dieselben Formate wie der Ordner-Import. Eine Word-, HTML-, RTF- oder CSV-Datei wird beim Öffnen nach Markdown gewandelt und als neuer Tab angezeigt.

Grenze: 260 Zeichen Pfadlänge NEU v3.20

Windows erlaubt für einen Dateipfad standardmäßig nur 260 Zeichen. Bei tief verschachtelten Ordnern und langen Seitentiteln kann diese Grenze gerissen werden – die Seite lässt sich dann nicht als Datei ablegen.

Bis v3.19 geschah das lautlos: Die Seite fehlte einfach im Ordner data\pages\. Seit v3.20 erscheint eine Meldung, die die betroffenen Seiten nennt.

Backup

Über Datei → Backup erstellen … wird ein vollständiges ZIP-Archiv aller Seiten, Ordner und der Datenbank erstellt.

Das Archiv enthält:

• manifest.json – Metadaten (Datum, Anzahl Seiten/Ordner, Version)
• data/index.db – die SQLite-Datenbank
• pages/*.md – alle Seiten als Markdown-Dateien

Export & Druck

Export einer Seite

Über Datei → Exportieren kann die aktuell geöffnete Seite exportiert werden:

• HTML: vollständige HTML-Datei mit eingebettetem CSS.
• PDF: Druckdatei über PyQt6's PDF-Ausgabe. NEU v3.27 Eingebettete Bilder sind jetzt enthalten – bis v3.26 fehlten sie im PDF vollständig.
• Markdown: rohe .md-Datei.

Drucken (Ctrl+P)

Über Seite → Drucken oder Ctrl+P wird die aktuelle Seite über den Windows-Druckdialog ausgegeben.

Alle Seiten exportieren NEU v3.8

Vorgehen

1. Datei → Exportieren → Alle Seiten exportieren … aufrufen.
2. Format wählen:
   • HTML: jede Seite als fertige .html-Datei mit CSS im Ordner html/
   • Markdown: jede Seite als .md-Datei im Ordner markdown/
   • Beides: HTML- und Markdown-Dateien in einem ZIP
3. Speicherort und Dateinamen für das ZIP wählen.
4. Das ZIP wird erstellt – Anzahl der Seiten und Dateigröße werden angezeigt.

Einstellungen

Über Einstellungen → Einstellungen … öffnet sich der Einstellungsdialog. Seit v3.17 ist er in drei kompakte Reiter gegliedert (statt einer langen Scroll-Liste):

Reiter „Allgemein"

• Speicherort: Pfad der Wiki-Daten ändern oder zurücksetzen.
• Wiki-bl mit Windows starten NEU v3.17: legt einen Autostart-Eintrag in der Windows-Registry an (nur aktueller Benutzer, kein Adminrecht nötig). Der Eintrag wird bei jedem Programmstart automatisch auf den aktuellen Pfad aktualisiert – Autostart funktioniert also auch dann weiter, wenn der portable Programmordner verschoben wird. Beim Abhaken wird der Eintrag wieder sauber entfernt.
• Beim Schließen in den Infobereich minimieren NEU v3.17: Ist der Haken gesetzt, beendet ein Klick auf das Schließen-Kreuz das Programm nicht, sondern legt es als Symbol in den Infobereich neben der Uhr (Systray). Doppelklick auf das Symbol holt das Fenster zurück. Wirklich beendet wird über das Rechtsklick-Menü des Symbols („Beenden") oder über Datei → Beenden (Strg+Q).

Reiter „Darstellung"

• Editor-Schrift: Schriftart und -größe für den Editor.
• Erscheinungsbild: Hell- oder Dunkel-Theme.

Reiter „Verhalten"

• Automatisches Speichern: Autosave ein/aus, Intervall in Minuten.
• Tab-Begrenzung (neu v3.8): maximale Anzahl gleichzeitig offener Tabs (3–50, Standard 12).
• Links in der Vorschau: externe Links im Standard-Browser öffnen (Standard: an).
• Seiten immer zum Bearbeiten öffnen NEU v3.26: Rückfallebene zum neuen Lesemodus (siehe Kapitel „Lesen & Bearbeiten") – bei gesetztem Haken öffnen Seiten wie bis v3.25 sofort im Modus Geteilt statt im Lesemodus.

Tab-Begrenzung NEU v3.8

Verhalten

• Standard-Limit: 12 Tabs.
• Wird das Limit beim Öffnen einer neuen Seite erreicht, schließt das Programm automatisch den ältesten unveränderten Tab.
• Sind alle Tabs geändert (ungespeichert), erscheint eine Warnung und die Seite wird nicht geöffnet – erst einen Tab manuell schließen oder speichern.

Limit anpassen

Einstellungen → Einstellungen … → Reiter „Verhalten" → Abschnitt Tab-Begrenzung → Wert zwischen 3 und 50 einstellen → OK.

Dark Mode

Über Ansicht → Dunkler Modus oder erneuten Klick (Heller Modus) wird das Theme gewechselt. Die Einstellung wird dauerhaft gespeichert.

Backlinks

Backlinks zeigen, welche Seiten über [[WikiLinks]] miteinander verbunden sind. Ab v3.8 gibt es zwei Ansichten in einem Dialog mit zwei Tabs.

Dialog öffnen

• Backlinks dieser Seite: Ctrl+B  ·  Seite → Backlinks dieser Seite  ·  🔙-Button in der Tab-Toolbar
• Gesamtübersicht: Ctrl+Shift+B  ·  Seite → Backlinks Gesamtübersicht

Tab 1 – Backlinks dieser Seite

Zeigt alle Seiten, die einen [[WikiLink]] auf die aktuell geöffnete Seite enthalten. Doppelklick auf einen Eintrag öffnet die verlinkende Seite.

Tab 2 – Gesamtübersicht NEU v3.8

Listet alle [[WikiLinks]] des gesamten Wikis in der Form Quellseite → [[Zielseite]]:

• Grün: Zielseite existiert – Link funktioniert.
• Rot: Zielseite fehlt noch – „toter Link".
• Filterfeld: nach Quell- oder Zielseite filtern.
• Doppelklick öffnet die Quellseite.

Favoriten

Häufig benötigte Seiten können als Favoriten gespeichert werden. Sie erscheinen in der Favoriten-Leiste unterhalb der Haupt-Toolbar.

Favorit setzen / entfernen

Seite → Als Favorit merken oder Ctrl+D. Im Seitenbaum werden Favoriten mit einem ★ gekennzeichnet.

Favorit aus der Leiste entfernen

Rechtsklick auf einen Favoriten-Button → Aus Favoriten entfernen.

Seitenbaum-Sortierung

Über Ansicht → Seitenbaum sortieren:

• Alphabetisch (Standard): A–Z.
• Nach Datum (neu zuerst): zuletzt bearbeitete Seiten oben.
• Manuell (Drag & Drop): Reihenfolge selbst bestimmen.

Auto-Tagging

Über Seite → Tags vorschlagen öffnet sich der Tag-Dialog.

Lokale Analyse (offline)

Analysiert den Seiteninhalt und schlägt häufige bedeutsame Wörter als Tags vor. Ohne Internetverbindung.

KI-Vorschlag (Anthropic API)

Claude schlägt 5–8 treffende Tags vor. Benötigt einen Anthropic API-Key (sk-ant-…, erhältlich unter console.anthropic.com).

Tags übernehmen

Vorschläge anklicken → Ausgewählt übernehmen → OK.

Tag per Rechtsklick aus Markierung NEU v3.10

Schneller geht's direkt aus dem Text heraus: Begriff oder Textstelle markieren – sowohl im Editor (Markdown-Quelltext) als auch in der Vorschau (gerenderte Ansicht) – dann rechte Maustaste → „… als Tag vorschlagen".

Der Tag-Dialog öffnet sich daraufhin automatisch mit der Markierung bereits als Tag in der Tags-Zeile eingetragen (zusätzlich zu eventuell schon vorhandenen Tags). Die lokale Analyse läuft wie gewohnt parallel mit. Vor dem Bestätigen lässt sich der vorgeschlagene Tag in der Tags-Zeile noch anpassen oder wieder entfernen.

Tastaturkürzel

EXE erstellen

Für den Build wird PyInstaller verwendet. Die Batch-Datei erledigt alles automatisch:

1. Alle Dateien in einen Ordner legen:
   wiki_bl_v3_26.py  ·  wiki_bl_v3_26.spec  ·  wiki.ico  ·  build_wiki_bl_v3_26.bat
2. Doppelklick auf build_wiki_bl_v3_26.bat.
3. Die Batch installiert fehlende Pakete (PyInstaller, markdown) automatisch.
4. Die EXE liegt danach in dist\Wiki-bl\Wiki-bl_v3.27.exe.

Warum –onedir und nicht –onefile?

PyQt6 mit QtWebEngine startet als Einzeldatei (--onefile) sehr langsam. Mit --onedir startet die Anwendung sofort.

Warum braucht die EXE einen _internal-Ordner? NEU v3.24

PyQt6 + QtWebEngine bringen praktisch einen kompletten Chromium-Browser mit (Rendering-Engine, Sprachdateien, Ressourcen). Bei --onedir landet das alles sichtbar im Ordner _internal neben der EXE, statt bei jedem Start unsichtbar in einen Temp-Ordner entpackt zu werden. Seit v3.24 schließt die .spec-Datei ungenutzte Qt-Module aus (Bluetooth, Multimedia, Qml/Quick, Sensoren u.a.) und das Build-Skript entfernt nach dem Bauen überflüssige WebEngine-Sprachdateien – der Ordner bleibt trotzdem vorhanden, wird aber spürbar kleiner.

Manueller Build

pip install pyinstaller markdown
pyinstaller wiki_bl_v3_26.spec --noconfirm

Eigenes Icon

Ersetzen Sie wiki.ico durch eine eigene ICO-Datei (gleicher Name) und führen Sie den Build erneut aus.

Versionshistorie

Lizenz & Haftungsausschluss

© 2026 Bernhard Lickert  ·  entwickelt mit Claude (Anthropic)