{"id":18976659,"url":"https://github.com/paul-schuhm/doc-pandoc-extensions","last_synced_at":"2026-04-09T11:30:18.514Z","repository":{"id":208417309,"uuid":"721579926","full_name":"paul-schuhm/doc-pandoc-extensions","owner":"paul-schuhm","description":"De la documentation sur l'usage plus avancé de pandoc et de son système d'extension","archived":false,"fork":false,"pushed_at":"2023-11-21T11:02:16.000Z","size":300,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-01T09:26:39.508Z","etag":null,"topics":["documentation","francais","markdown","markdown-math","markdown-to-html","markdown-to-pdf","mathml","pandoc","pandoc-markdown","pandoc-template"],"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/paul-schuhm.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,"governance":null}},"created_at":"2023-11-21T10:59:48.000Z","updated_at":"2024-10-23T15:23:32.000Z","dependencies_parsed_at":"2023-11-21T12:26:48.128Z","dependency_job_id":"5a4a03eb-0f08-4b1f-be02-28e50c4e214b","html_url":"https://github.com/paul-schuhm/doc-pandoc-extensions","commit_stats":null,"previous_names":["paul-schuhm/doc-pandoc-extensions"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paul-schuhm%2Fdoc-pandoc-extensions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paul-schuhm%2Fdoc-pandoc-extensions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paul-schuhm%2Fdoc-pandoc-extensions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paul-schuhm%2Fdoc-pandoc-extensions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paul-schuhm","download_url":"https://codeload.github.com/paul-schuhm/doc-pandoc-extensions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239978060,"owners_count":19728271,"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","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":["documentation","francais","markdown","markdown-math","markdown-to-html","markdown-to-pdf","mathml","pandoc","pandoc-markdown","pandoc-template"],"created_at":"2024-11-08T15:25:45.053Z","updated_at":"2026-04-09T11:30:18.447Z","avatar_url":"https://github.com/paul-schuhm.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Utiliser les extensions de pandoc\n\n- [Utiliser les extensions de pandoc](#utiliser-les-extensions-de-pandoc)\n  - [Lister les extensions](#lister-les-extensions)\n  - [Expliciter les formats d'entrée et de sortie](#expliciter-les-formats-dentrée-et-de-sortie)\n  - [Activer/Désactiver une extension](#activerdésactiver-une-extension)\n  - [Markdown vers Markdown sans commentaires, avec l'option `--strip-comments`](#markdown-vers-markdown-sans-commentaires-avec-loption---strip-comments)\n  - [Markdown vers PDF](#markdown-vers-pdf)\n  - [Markdown avec des expressions mathématiques](#markdown-avec-des-expressions-mathématiques)\n  - [Une commande utile](#une-commande-utile)\n  - [Références](#références)\n\n\nUn peu de documentation sur l'usage plus avancé de pandoc et de ses extensions. Quelques templates utiles sont également présentés pour publier vers du HTML et PDF avec des expressions mathématiques.\n\n## Lister les extensions\n\n~~~bash\n#Liste toutes les extensions\npandoc --list-extensions\n#Liste les extensions pour le format markdown\npandoc --list-extensions=markdown\n~~~\n\nLes extensions indiquées avec un `+` sont activées par défaut, un `-` sont désactivées par défaut.\n\n## Expliciter les formats d'entrée et de sortie\n\nListe tous les formats d'entrée et de sorties gérés par pandoc\n\n~~~bash\npandoc --list-input-formats\npandoc --list-output-formats\n~~~\n\nPour expliciter le format d'entrée, utiliser l'option `-f/--from`, pour le format de sortie `-t/--to`\n\n~~~bash\n#Convertir hello.txt du markdown vers LaTeX (sur la sortie standard)\npandoc -f markdown -t latex hello.txt\n#Convertir un fichier html vers du markdown\npandoc -f html -t markdown index.html\n~~~\n\n## Activer/Désactiver une extension\n\nPour activer ou désactiver une extension, indiquer respectivement le format suivi d'un `+` ou `-` suivi du nom de l'extension\n\n~~~bash\n#Activer l'extension tex_math_single_backslash\npandoc -f markdown+tex_math_double_backslash -t html5 -o output.pdf test-document.md --mathml\n#Désactiver les footnotes\npandoc -f markdown-footnotes -t html5 -o output.pdf test-document.md  \n~~~\n\n## Markdown vers Markdown sans commentaires, avec l'option `--strip-comments`\n\nTrès utile pour garder ses sources commentées et publier au format markdown (publié sur un dépôt par exemple) sans ses commentaires\n\n~~~bash\npandoc -f markdown -t markdown --strip-comments test-document.md -o test-document-without-comments.md\n#ou plus compactement\npandoc --strip-comments test-document.md -o test-document-without-comments.md\n~~~\n\n## Markdown vers PDF\n\nPublication en passant par le format HTML (pour appliquer une feuille de style CSS)\n\n~~~bash\npandoc test-document.md -t html5 -o output-via-html.pdf --css style.css\n~~~\n\nPublication directement avec pdflatex (LateX like)\n\n~~~bash\npandoc test-document.md --pdf-engine=pdflatex -o output-via-pdflatex.pdf\n~~~\n\n\u003e En utilisant pdflatex, on a naturellement accès aux expressions mathématiques LateX.\n\n## Markdown avec des expressions mathématiques\n\nPlusieurs options :\n\n- [MathML](https://www.w3.org/Math/), MathML is a low-level specification for mathematical and scientific content on the Web and beyond, publié par le W3C. Supporté par les browsers et les lecteurs e-books.\n- [mathjax](https://www.mathjax.org/)\n\nPublication en passant par le format HTML (pour appliquer une feuille de style CSS) avec mathml :\n\n~~~bash\n#Avec l'option mathml\npandoc test-document.md -t html5 -o output.pdf --mathml\n#Avec l'option mathml et block double backslash (recommandé)\npandoc -f markdown+tex_math_double_backslash -t html5 -o output.pdf test-document.md --mathml\n~~~\n\n## Une commande utile\n\nPublier le fichier markdown `source.md` vers PDF `output.pdf` avec expressions et blocs mathématiques TeX (inline et display) et une feuille de style CSS :\n\n~~~bash\npandoc -f markdown+tex_math_double_backslash -t html5 -o output.pdf source.md --mathml --css=style.css\n~~~\n\nVoir le fichier [`template.md`](./template.md) pour un récapitulatif d'un document type utile, ainsi que [sa feuille de style](./style.css).\n\n## Références\n\n- `man pandoc` : pages de manuel de pandoc\n- [Site officiel de pandoc](https://pandoc.org)\n- [Pandoc manual : Extensions](https://pandoc.org/MANUAL.html#extensions)\n- [Pandoc manual : Syntax highlighting](https://pandoc.org/MANUAL.html#syntax-highlighting), pour mettre en exergue le code source dans différents langages et options","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaul-schuhm%2Fdoc-pandoc-extensions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaul-schuhm%2Fdoc-pandoc-extensions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaul-schuhm%2Fdoc-pandoc-extensions/lists"}