Was macht markdown-to-obsidian-paper-card?
Codex-Fähigkeit zur Erstellung zweisprachiger Obsidian-Papierkarten aus Markdown oder Zotero, mit verifizierter Übersetzung und stabilen Ressourcen.
Übersicht
Diese Fähigkeit konvertiert Markdown-Inhalte oder Zotero-Einträge in formatierte Obsidian-Notizen (Papierkarten). Sie unterstützt zweisprachige Ausgaben, typischerweise mit einer primären und einer sekundären Sprache (z. B. Deutsch und Englisch), und verwendet einen verifizierten Übersetzungsprozess, um die Genauigkeit des Textes sicherzustellen. Die erzeugten Ressourcen (Bilder, Metadaten) sind stabil und bleiben bei Änderungen der Quelle erhalten.
Verwendung
- Eingabe: Markdown-Datei oder Zotero-Bibliothekseintrag.
- Ausgabe: Obsidian-kompatible Notiz mit strukturierten Feldern (Titel, Autoren, Abstract, Tags, Quellenangabe).
- Übersetzung: Automatische, verifizierte Übersetzung des Abstracts oder des gesamten Inhalts in die Zielsprache.
- Ressourcen: Lokale Kopien von Bildern und anderen Anhängen in einem konfigurierbaren Ordner (
assets/).
Voraussetzungen
- Obsidian (empfohlen, aber nicht zwingend erforderlich)
- Codex (oder kompatibler KI-Agent)
- Zotero (optional, für automatischen Import)
- Python 3.8+ (für Übersetzungs- und Verarbeitungsskripte)
Konfiguration
Erstellen Sie eine .env-Datei im Stammverzeichnis des Projekts:
OBSIDIAN_VAULT_PATH=/pfad/zu/ihrem/vault
ZOTERO_API_KEY=ihr_zotero_api_schluessel
TRANSLATION_SERVICE=libre|deepl|google
LANGUAGE_PRIMARY=de
LANGUAGE_SECONDARY=en
Verwendung mit Codex
- Öffnen Sie Codex in Ihrem Obsidian-Vault.
- Führen Sie den Befehl aus:
/markdown-to-obsidian-paper-card --input pfad/zur/datei.md - Oder für Zotero:
/markdown-to-obsidian-paper-card --zotero-id IHRE_ZOTERO_ID
Funktionsweise
- Parsen: Die EIngabe (Markdown oder Zotero) wird in ein strukturiertes Format geparst.
- Übersetzung: Der Text (z. B. Abstract) wird mit dem konfigurierten Dienst übersetzt und auf Korrektheit überprüft.
- Ressourcenverwaltung: Bilder und Anhänge werden lokal gespeichert und in der Notiz referenziert.
- Erstellung: Die Obsidian-Notiz wird im Zielordner des Vaults erstellt, mit YAML-Frontmatter und Markdown-Formatierung.
Beispielausgabe
---
title: "Beispieltitel"
authors: ["Max Mustermann", "Erika Musterfrau"]
date: 2024-01-01
tags: ["#KI", "#NLP"]
---
# Beispieltitel
**Abstract (Deutsch)**: Dies ist eine Beispielzusammenfassung.
**Abstract (English)**: This is an example abstract.
## Ressourcen
- ![[beispielbild.png]]
- [Volltext](beispiel.pdf)
Fehlerbehebung
- Übersetzungsfehler: Überprüfen Sie den
TRANSLATION_SERVICEund den API-Schlüssel. - Ressourcen nicht gefunden: Stellen Sie sicher, dass der Pfad im Vault korrekt ist und die Dateien existieren.
- Zotero-Import schlägt fehl: Überprüfen Sie Ihre Zotero-API-Anmeldedaten und die Bibliotheks-ID.
Lizenz
MIT-Lizenz