{"id":33102376,"url":"https://github.com/websealevel/poc-marp","last_synced_at":"2025-11-19T16:01:49.415Z","repository":{"id":47405203,"uuid":"516114789","full_name":"websealevel/poc-marp","owner":"websealevel","description":"Poc marp, ecosystème markdown pour produire des slides à partir de fichiers markdown","archived":false,"fork":false,"pushed_at":"2023-07-25T15:59:42.000Z","size":5132,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-08T02:21:54.007Z","etag":null,"topics":["markdown","marp","marpit","marpit-markdown","slides"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/websealevel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-20T19:47:01.000Z","updated_at":"2023-07-25T15:51:02.000Z","dependencies_parsed_at":"2022-09-03T02:30:29.744Z","dependency_job_id":null,"html_url":"https://github.com/websealevel/poc-marp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/websealevel/poc-marp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websealevel%2Fpoc-marp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websealevel%2Fpoc-marp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websealevel%2Fpoc-marp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websealevel%2Fpoc-marp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/websealevel","download_url":"https://codeload.github.com/websealevel/poc-marp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websealevel%2Fpoc-marp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285277271,"owners_count":27144150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-19T02:00:05.673Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","marp","marpit","marpit-markdown","slides"],"created_at":"2025-11-14T22:00:36.038Z","updated_at":"2025-11-19T16:01:49.395Z","avatar_url":"https://github.com/websealevel.png","language":"HTML","funding_links":[],"categories":["Présentations (slides) avec Markdown"],"sub_categories":["Racket, le *langage-oriented programming language*"],"readme":"# Marp\n\n- [Marp](#marp)\n  - [Instalation du programme en ligne de commande (`marp-cli`)](#instalation-du-programme-en-ligne-de-commande-marp-cli)\n    - [macOS](#macos)\n    - [Windows](#windows)\n    - [Debian/Ubuntu](#debianubuntu)\n      - [Installation via les binaires](#installation-via-les-binaires)\n      - [Installation via `node` et `npm`](#installation-via-node-et-npm)\n  - [Afficher la liste des options](#afficher-la-liste-des-options)\n  - [Watch (*hot reload*)](#watch-hot-reload)\n  - [Conversions](#conversions)\n    - [Au format PDF](#au-format-pdf)\n    - [Au format HTML](#au-format-html)\n    - [Au format PPTX (powerpoint) **lecture seule**](#au-format-pptx-powerpoint-lecture-seule)\n    - [Au format PPTX (powerpoint) **éditable**](#au-format-pptx-powerpoint-éditable)\n  - [Conversion avec inclusion de fichiers multimédias](#conversion-avec-inclusion-de-fichiers-multimédias)\n    - [Vers d'autres formats (XML, LaTeX, etc.)](#vers-dautres-formats-xml-latex-etc)\n  - [Création d'un thème](#création-dun-thème)\n  - [Workflow](#workflow)\n  - [Autoriser le markup HTML dans les slides](#autoriser-le-markup-html-dans-les-slides)\n  - [Points à eclaircir](#points-à-eclaircir)\n  - [Ressources](#ressources)\n\n\n## Instalation du programme en ligne de commande (`marp-cli`)\n\nToutes les possibilités d'installation de l'application sont listées [sur le dépôt](https://github.com/marp-team/marp-cli).\n\n### macOS\n\nInstaller marp via le gestionnaire de paquets [Homebrew](https://brew.sh/index_fr)\n\n~~~bash\nbrew install marp-cli\n~~~\n\n### Windows\n\nInstaller marp via le gestionnaire de paquets [Scoop](https://scoop.sh/)\n\n~~~bash\nscoop install marp\n~~~\n\n### Debian/Ubuntu\n\n#### Installation via les binaires\n\nTélécharger l'archive contenant les binaires [depuis son dépôt GitHub](https://github.com/marp-team/marp-cli/releases).\n\nExtraire l'archive\n\n~~~bash\ntar xvzf marp-cli-v{derniere version}-linux-tar.gz\n~~~\n\nCopiez l'éxecutable présent dans l'archive dans un répertoire présent sur le `PATH`, par exemple\n\n~~~bash\nsudo cp marp /usr/local/bin\n~~~\n\nVérifier que marp est bien installé\n\n~~~bash\nmarp -h\n~~~\n\n#### Installation via `node` et `npm`\n\nInstaller [node](https://packages.debian.org/fr/sid/nodejs) et [npm](le gestionnaire de paquets de node), puis installer `marp-cli` globalement (option `-g`)\n\n~~~bash\nsudo apt-get update\nsudo apt-get install nodejs npm\nnpm install -g @marp-team/marp-cli\n~~~\n\n## Afficher la liste des options\n\nConsulter la liste des options offertes par marp\n\n~~~bash\nmarp -h\n~~~\n\nIl est possible de mettre toutes les options dans un fichier de configuration `marp.conf`, puis de le charger\n\n~~~bash\nmarp -c marp.conf slide-deck.md\n~~~\n\n## Watch (*hot reload*)\n\nOn peut également observer notre fichier de présentation markdown avec l'option `-w`\n\n~~~bash\nmarp -w slide-deck.md\n~~~\n\nMarp convertira uniquement le fichier indiqué lorsqu'il observera des modifications (ici en HTML par défaut). On peut donc ouvrir la présentation HTML générée dans notre navigateur pour avoir une preview optimisée avec un *hot reload*.\n\n## Conversions\n\n### Au format PDF\n\nUtilise Chrome ou Chromium\n\n~~~bash\nmarp --pdf slide-deck.md\n~~~\n\n### Au format HTML\n\n~~~bash\nmarp slide-deck.md\n~~~\n\n### Au format PPTX (powerpoint) **lecture seule**\n\nLa conversion opère juste une conversion en images au format `.pptx`. Le document peut être ouvert dans powerpoint mais **non éditable**\n\n~~~bash\nmarp --pptx slide-deck.md\n~~~\n\n### Au format PPTX (powerpoint) **éditable**\n\nPour convertir la présentation markdown en pptx éditable, on peut passer [par le format PDF](#au-format-pdf) puis utiliser un outil comme [PDF to Powerpoint Converter](https://pdf.online/pdf-to-powerpoint-converter) ou [Adobe](https://www.adobe.com/acrobat/online/pdf-to-ppt.html)\n\n## Conversion avec inclusion de fichiers multimédias\n\nIl faut forcer le html avec l'option `--html`. Pour des exports PDF ou pptx, il faut également autoriser les fichiers locaux avec l'option `--allow-local-files`. Par exemple,\n\n~~~bash\nmarp --theme my-theme.css --pdf --allow-local-files slide-deck.md\n~~~\n\nou\n\n~~~bash\nmarp --theme my-theme.css --pptx --allow-local-files slide-deck.md\n~~~\n\n**On ne peut pas inclure de vidéos dans un fichier PDF et donc dans un fichier pptx avec cette méthode.** Il vaut mieux uploader la vidéo sur une plateforme, par exemple Youtube et mettre un lien vers la vidéo.\n\n### Vers d'autres formats (XML, LaTeX, etc.)\n\nPour cela on peut passer par [la conversion HTML](#au-format-html) puis utiliser [pandoc](https://pandoc.org/index.html)\n\n## Création d'un thème\n\nOn peut créer un thème dédié au projet directement en CSS `my-theme.css` et l'utiliser avec l'option `-theme`\n\n~~~bash\nmarp --theme my-theme.css slide-deck.md\n~~~\n\n## Workflow\n\nWatch les sources markdown avec un thème custom\n\n~~~bash\nmarp --theme my-theme.css -w slide-deck.md\n~~~\n\nExporter vers des images dans un fichier powerpoint\n\n~~~bash\nmarp --theme my-theme.css --pptx slide-deck.md\n~~~\n\nLes notes seront affichées pour la personne qui fait la présentation.\n\n## Autoriser le markup HTML dans les slides\n\nUtiliser l'option `--html`\n\n~~~bash\nmarp --html --theme my-theme.css -w slide-deck.md\n~~~\n\n\n## Points à eclaircir\n\n- La directive `_class`\n- import video et images\n\n## Ressources\n\n- [Marp écosystème](https://marp.app/)\n- [Marpit framework](https://marpit.marp.app/), sur quoi est basé marp\n- [Marpit API](https://marpit-api.marp.app/index.html)\n- [Doc officielle Marp CLI](https://github.com/marp-team/marp-cli)\n- [Produire un powerpoint editable dans le workflow de Marp](https://github.com/marp-team/marp/discussions/82), l'export vers pptx de marp ne cree pas une présentation éditable mais une version images. Pour produire un ppt éditable il faut passer par le format pdf avant\n- [Pandoc](https://pandoc.org/index.html), un convertisseur de document universel et éprouvé\n- [Convertisseur pdf vers powerpoint](https://pdf.online/pdf-to-powerpoint-converter), un outil de conversion en ligne gratuit permettant de convertir un fichier PDF vers un fichier pptx éditable\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebsealevel%2Fpoc-marp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebsealevel%2Fpoc-marp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebsealevel%2Fpoc-marp/lists"}