le876/markdown-to-obsidian-paper-card

Que fait markdown-to-obsidian-paper-card ?

Compétence Codex pour créer des fiches de lecture bilingues dans Obsidian à partir de Markdown ou Zotero, avec traduction vérifiée et ressources stables.

Installation

1. Copier ce dossier de compétence dans votre répertoire de compétences Codex
2. Configurer config.yml avec vos chemins Obsidian et clés API (profils Zotero, etc.)
3. (Optionnel) Installer le plugin Zotero pour Obsidian si vous utilisez des sources Zotero

Utilisation

# Depuis un fichier Markdown local
codex run le876/markdown-to-obsidian-paper-card --input path/to/article.md

# Depuis une entrée Zotero (par clé de citation)
codex run le876/markdown-to-obsidian-paper-card --zotero-key CITATION_KEY

Fichier d'entrée

• Format : .md (Markdown) avec le texte brut de l'article ou du chapitre
• Métadonnées optionnelles : En-tête YAML avec title, authors, date, doi

Fiche de sortie

L'extension crée une note Obsidian dans le dossier configuré, avec le format suivant :

---
title: "Titre original"
translated_title: "Titre traduit"
source: "zotero://select/items/..."
tags: [paper, bilingue]
---

# Article original

Contenu de la fiche...

## Traduction vérifiée

Texte traduit...

## Concepts clés

- Concept 1 : Explication
- Concept 2 : Explication

## Citations importantes

> Citation... [^1]

## Références

[^1]: Lien ou note...

Configuration

Éditez config.yml :

obsidian_vault: "/chemin/vers/votre/coffre"
output_folder: "Fiches de lecture"
zotero_library_id: "votre_id_bibliothèque"
translation_api: "deepL"
resource_folder: "_resources"

Fonctionnement

1. Analyse d'entrée : Lit le fichier Markdown ou récupère les métadonnées depuis Zotero
2. Traduction : Traduit le titre et le résumé via DeepL (ou autre API configurée)
3. Vérification : Affiche la traduction pour approbation manuelle avant finalisation
4. Extraction de ressources : Télécharge les images et graphiques, les stocke dans _resources
5. Génération de fiche : Assemble la note Obsidian avec les sections standard

Plateformes supportées

• Claude Code
• Cursor
• Codex CLI

Dépendances

• requests (Python) ou équivalent pour les appels API
• pandoc (optionnel, pour la conversion de formats)
• Accès à l'API DeepL (ou autre service de traduction)

Licence

MIT

---

Développé par le876. Pour des questions ou contributions, ouvrez une issue sur le dépôt.