{"id":4,"date":"2025-07-09T08:25:27","date_gmt":"2025-07-09T06:25:27","guid":{"rendered":"https:\/\/e-publish.uliege.be\/md2\/?p=4"},"modified":"2025-10-09T10:26:02","modified_gmt":"2025-10-09T08:26:02","slug":"introduction","status":"publish","type":"front-matter","link":"https:\/\/e-publish.uliege.be\/md2\/front-matter\/introduction\/","title":{"raw":"Introduction","rendered":"Introduction"},"content":{"raw":"<div class=\"textbox\">\r\n\r\nLorsque je pose, \u00e0 mon entourage, la question\u00a0:\r\n<ul>\r\n \t<li>quel logiciel utilises-tu pour r\u00e9diger tes textes ?<\/li>\r\n<\/ul>\r\nLa r\u00e9ponse est, quasi invariablement\u00a0:\r\n<ul>\r\n \t<li>Word.<\/li>\r\n<\/ul>\r\nSi j\u2019ajoute\u00a0:\r\n<ul>\r\n \t<li>et pour prendre des notes ?<\/li>\r\n<\/ul>\r\nLa r\u00e9ponse la plus fr\u00e9quente est\u00a0:\r\n<ul>\r\n \t<li>aussi, pourquoi ?<\/li>\r\n<\/ul>\r\n<\/div>\r\n<span class=\"firstcharacter\"> P<\/span>our reprendre la main face aux imp\u00e9ratifs de l\u2019industrie informatique, il est indispensable de revoir nos m\u00e9thodes, outils et formats.\r\n\r\nCet ouvrage est une nouvelle \u00e9dition, enti\u00e8rement revue et augment\u00e9e, du manuel \"Markdown &amp; vous\" publi\u00e9 en 2023 sur le site e-publish[footnote]<a href=\"https:\/\/e-publish.uliege.be\/md\" target=\"_blank\" rel=\"noopener\">https:\/\/e-publish.uliege.be\/md<\/a>[\/footnote] de l\u2019Universit\u00e9 de Li\u00e8ge. Il propose une r\u00e9flexion sur une approche durable, ouverte et libre qui redonne la pleine ma\u00eetrise dans les activit\u00e9s de r\u00e9daction.\r\n\r\nLe format Markdown est un langage s\u00e9mantique simple, lisible par les humains et p\u00e9renne gr\u00e2ce \u00e0 sa simplicit\u00e9 syntaxique. Il permet de revenir \u00e0 des m\u00e9thodes qui vont \u00e0 l\u2019essentiel en faisant les choses dans l\u2019ordre, \u00e9crire, illustrer, \u00e9diter puis publier, sans perte de temps et d\u2019\u00e9nergie inutiles.\r\n\r\nLe choix de Markdown supprime la d\u00e9pendance \u00e0 un logiciel sp\u00e9cifique, comme c\u2019est le cas avec un traitement de texte. Ce choix est aussi une d\u00e9marche li\u00e9e \u00e0 la science ouverte. En travaillant avec Markdown et <em>Pandoc<\/em> on va ouvrir l\u2019ensemble de nos textes (<em>Open Access<\/em>), dans des formats ouverts (<em>Open Data<\/em>) avec des logiciels ouverts (<em>Open Source<\/em>).\r\n\r\nMarkdown est aussi une solution <em>Single Source Publishing<\/em> (\u00e9dition \u00e0 partir d'une source unique), c\u2019est-\u00e0-dire qu\u2019avec un (ou plusieurs) m\u00eame(s) fichier(s) source(s) on peut produire des documents dans diff\u00e9rents formats (essentiellement docx, odt, HTML, ePub et pdf).\r\n\r\nPlusieurs th\u00e8ses soutenues r\u00e9cemment, \u00e0 Bordeaux <span class=\"citation\" data-cites=\"perret_lheritage_2022\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_perr2022\">Perret, 2022<\/a>), \u00e0 Rouen (<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_dehut2023\">Dehut, 2023<\/a>) et <\/span>\u00e0 Montr\u00e9al <span class=\"citation\" data-cites=\"fauchie_fabriquer_2024\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_fauc2024\">Fauchi\u00e9, 2024<\/a>)<\/span>, font une large part \u00e0 Markdown. Ces travaux sont le signe que le monde acad\u00e9mique commence \u00e0 s\u2019int\u00e9resser s\u00e9rieusement \u00e0 Markdown comme format de r\u00e9daction.\r\n\r\nL\u2019ouvrage est divis\u00e9 en quatre parties.\r\n\r\nLa <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/reprendre-le-controle\/\">premi\u00e8re<\/a> fait le point sur les \u00e9volutions du num\u00e9rique, de la science ouverte, du d\u00e9veloppement durable et des outils actuels. L\u2019objectif de cette premi\u00e8re partie est de pr\u00e9senter la situation avec conviction pour susciter la r\u00e9flexion et \u00e9ventuellement induire des changements.\r\n\r\nLa <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/le-pandoc-markdown\/\">deuxi\u00e8me<\/a> partie pr\u00e9sente le Pandoc-Markdown[footnote]Dans ce manuel, nous utiliserons l'expression \"Pandoc-Markdown\" pour d\u00e9signer la variante <em>Pandoc<\/em> de Markdown.[\/footnote], les choix techniques et les bases de l\u2019\u00e9criture avec ce langage.\r\n\r\nLa <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/latex\/\">troisi\u00e8me<\/a> partie pr\u00e9sente l\u2019utilisation de Markdown pour transformer la puissance et la complexit\u00e9 de <em>LaTeX<\/em> (un \u00e9diteur de textes scientifiques) en un processus accessible au plus grand nombre.\r\n\r\nLa <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/exemples-et-modeles\/\">quatri\u00e8me<\/a> partie propose des exemples et des mod\u00e8les.\r\n\r\nL\u2019ouvrage est compl\u00e9t\u00e9 par des <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/exercices\/\">exercices<\/a>, un <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/aide-memoire\/\">aide m\u00e9moire<\/a> et des <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/pour-aller-plus-loin\/\">sources compl\u00e9mentaires<\/a> pour aller plus loin.\r\n\r\nCe manuel rassemble les fonctions de base pr\u00e9sentes dans tous les bons manuels comme le manuel de <span class=\"citation\" data-cites=\"mailund_introducing_2019\">Mailund (2019)<\/span>, \"<em>Introducing Markdown and Pandoc: using markup language and document converter\"<\/em> ou des fonctions plus \"pratiques\" glan\u00e9es au fil de lectures et de recherches.\r\n\r\nApprendre Markdown (ou un autre format) ce n\u2019est pas juste apprendre un nouveau langage mais c\u2019est avant tout adh\u00e9rer \u00e0 de nouvelles m\u00e9thodes et \u00e0 de nouveaux outils, c\u2019est d\u00e9cider de reprendre le contr\u00f4le et tourner d\u00e9finitivement le dos \u00e0 l\u2019imp\u00e9ratif fonctionnel si bien d\u00e9crit par <span class=\"citation\" data-cites=\"vitali-rosati_eloge_2024\">Vitali-Rosati (<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_vita2024a\">2024a<\/a>)<\/span>.\r\n<blockquote>\"La technologie nous promet de nous rendre libres en nous d\u00e9livrant de toutes les t\u00e2ches ennuyeuses, triviales, r\u00e9p\u00e9titives, purement mat\u00e9rielles, en nous fournissant des 'solutions' de plus en plus performantes, simples, intuitives, rapides et efficaces. Les GAFAM[footnote]Pour <em>Google, Amazon, Facebook, Apple<\/em> et <em>Microsoft<\/em>.[\/footnote] nous font r\u00eaver d\u2019un monde qui fonctionne tout seul, d\u2019un monde o\u00f9 nous sommes pris\u00b7es en charge jusqu\u2019\u00e0 nos identit\u00e9s par un petit nombre de compagnies priv\u00e9es. Mais cette d\u00e9livrance se fait au prix d\u2019une perte totale d\u2019autonomie, avec une d\u00e9pendance compl\u00e8te \u00e0 ces technologies et \u00e0 ces entreprises\" <span class=\"citation\" data-cites=\"vitali-rosati_eloge_2024\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_vita2024a\">Vitali-Rosati, 2024a<\/a>)<\/span>.<\/blockquote>\r\nAdopter Markdown est un choix qui ne va pas n\u00e9cessairement de soi. Il y a, dans un premier temps, des t\u00e2tonnements, des pertes de temps pour r\u00e9soudre un probl\u00e8me particulier, des renoncements mais, \u00e0 l\u2019arriv\u00e9e, le gain de temps et de libert\u00e9 est \u00e9vident.\r\n<blockquote>\"Il faut reconna\u00eetre que la production des documents \u00e0 partir du Markdown en conjonction de <em>Pandoc<\/em> demande dans un premier temps un certain investissement, en tout cas une motivation quotidienne, et peut-\u00eatre quelque chose d\u2019une r\u00e9solution ind\u00e9fectible. Cet investissement nous semble pourtant la contrepartie indispensable dont on doit s\u2019acquitter dans le dessein de s\u2019approprier, au sens de faire sien, ce qu\u2019est devenu l\u2019\u00e9crit dans notre soci\u00e9t\u00e9 aujourd\u2019hui\" <span class=\"citation\" data-cites=\"dehut_en_2018\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_dehu2018\">Dehut, 2018<\/a>).<\/span><\/blockquote>","rendered":"<div class=\"textbox\">\n<p>Lorsque je pose, \u00e0 mon entourage, la question\u00a0:<\/p>\n<ul>\n<li>quel logiciel utilises-tu pour r\u00e9diger tes textes ?<\/li>\n<\/ul>\n<p>La r\u00e9ponse est, quasi invariablement\u00a0:<\/p>\n<ul>\n<li>Word.<\/li>\n<\/ul>\n<p>Si j\u2019ajoute\u00a0:<\/p>\n<ul>\n<li>et pour prendre des notes ?<\/li>\n<\/ul>\n<p>La r\u00e9ponse la plus fr\u00e9quente est\u00a0:<\/p>\n<ul>\n<li>aussi, pourquoi ?<\/li>\n<\/ul>\n<\/div>\n<p><span class=\"firstcharacter\"> P<\/span>our reprendre la main face aux imp\u00e9ratifs de l\u2019industrie informatique, il est indispensable de revoir nos m\u00e9thodes, outils et formats.<\/p>\n<p>Cet ouvrage est une nouvelle \u00e9dition, enti\u00e8rement revue et augment\u00e9e, du manuel \u00ab\u00a0Markdown &amp; vous\u00a0\u00bb publi\u00e9 en 2023 sur le site e-publish<a class=\"footnote\" title=\"https:\/\/e-publish.uliege.be\/md\" id=\"return-footnote-4-1\" href=\"#footnote-4-1\" aria-label=\"Footnote 1\"><sup class=\"footnote\">[1]<\/sup><\/a> de l\u2019Universit\u00e9 de Li\u00e8ge. Il propose une r\u00e9flexion sur une approche durable, ouverte et libre qui redonne la pleine ma\u00eetrise dans les activit\u00e9s de r\u00e9daction.<\/p>\n<p>Le format Markdown est un langage s\u00e9mantique simple, lisible par les humains et p\u00e9renne gr\u00e2ce \u00e0 sa simplicit\u00e9 syntaxique. Il permet de revenir \u00e0 des m\u00e9thodes qui vont \u00e0 l\u2019essentiel en faisant les choses dans l\u2019ordre, \u00e9crire, illustrer, \u00e9diter puis publier, sans perte de temps et d\u2019\u00e9nergie inutiles.<\/p>\n<p>Le choix de Markdown supprime la d\u00e9pendance \u00e0 un logiciel sp\u00e9cifique, comme c\u2019est le cas avec un traitement de texte. Ce choix est aussi une d\u00e9marche li\u00e9e \u00e0 la science ouverte. En travaillant avec Markdown et <em>Pandoc<\/em> on va ouvrir l\u2019ensemble de nos textes (<em>Open Access<\/em>), dans des formats ouverts (<em>Open Data<\/em>) avec des logiciels ouverts (<em>Open Source<\/em>).<\/p>\n<p>Markdown est aussi une solution <em>Single Source Publishing<\/em> (\u00e9dition \u00e0 partir d&rsquo;une source unique), c\u2019est-\u00e0-dire qu\u2019avec un (ou plusieurs) m\u00eame(s) fichier(s) source(s) on peut produire des documents dans diff\u00e9rents formats (essentiellement docx, odt, HTML, ePub et pdf).<\/p>\n<p>Plusieurs th\u00e8ses soutenues r\u00e9cemment, \u00e0 Bordeaux <span class=\"citation\" data-cites=\"perret_lheritage_2022\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_perr2022\">Perret, 2022<\/a>), \u00e0 Rouen (<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_dehut2023\">Dehut, 2023<\/a>) et <\/span>\u00e0 Montr\u00e9al <span class=\"citation\" data-cites=\"fauchie_fabriquer_2024\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_fauc2024\">Fauchi\u00e9, 2024<\/a>)<\/span>, font une large part \u00e0 Markdown. Ces travaux sont le signe que le monde acad\u00e9mique commence \u00e0 s\u2019int\u00e9resser s\u00e9rieusement \u00e0 Markdown comme format de r\u00e9daction.<\/p>\n<p>L\u2019ouvrage est divis\u00e9 en quatre parties.<\/p>\n<p>La <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/reprendre-le-controle\/\">premi\u00e8re<\/a> fait le point sur les \u00e9volutions du num\u00e9rique, de la science ouverte, du d\u00e9veloppement durable et des outils actuels. L\u2019objectif de cette premi\u00e8re partie est de pr\u00e9senter la situation avec conviction pour susciter la r\u00e9flexion et \u00e9ventuellement induire des changements.<\/p>\n<p>La <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/le-pandoc-markdown\/\">deuxi\u00e8me<\/a> partie pr\u00e9sente le Pandoc-Markdown<a class=\"footnote\" title=\"Dans ce manuel, nous utiliserons l'expression &quot;Pandoc-Markdown&quot; pour d\u00e9signer la variante Pandoc de Markdown.\" id=\"return-footnote-4-2\" href=\"#footnote-4-2\" aria-label=\"Footnote 2\"><sup class=\"footnote\">[2]<\/sup><\/a>, les choix techniques et les bases de l\u2019\u00e9criture avec ce langage.<\/p>\n<p>La <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/latex\/\">troisi\u00e8me<\/a> partie pr\u00e9sente l\u2019utilisation de Markdown pour transformer la puissance et la complexit\u00e9 de <em>LaTeX<\/em> (un \u00e9diteur de textes scientifiques) en un processus accessible au plus grand nombre.<\/p>\n<p>La <a href=\"https:\/\/e-publish.uliege.be\/md2\/part\/exemples-et-modeles\/\">quatri\u00e8me<\/a> partie propose des exemples et des mod\u00e8les.<\/p>\n<p>L\u2019ouvrage est compl\u00e9t\u00e9 par des <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/exercices\/\">exercices<\/a>, un <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/aide-memoire\/\">aide m\u00e9moire<\/a> et des <a href=\"https:\/\/e-publish.uliege.be\/md2\/chapter\/pour-aller-plus-loin\/\">sources compl\u00e9mentaires<\/a> pour aller plus loin.<\/p>\n<p>Ce manuel rassemble les fonctions de base pr\u00e9sentes dans tous les bons manuels comme le manuel de <span class=\"citation\" data-cites=\"mailund_introducing_2019\">Mailund (2019)<\/span>, \u00ab\u00a0<em>Introducing Markdown and Pandoc: using markup language and document converter\u00a0\u00bb<\/em> ou des fonctions plus \u00ab\u00a0pratiques\u00a0\u00bb glan\u00e9es au fil de lectures et de recherches.<\/p>\n<p>Apprendre Markdown (ou un autre format) ce n\u2019est pas juste apprendre un nouveau langage mais c\u2019est avant tout adh\u00e9rer \u00e0 de nouvelles m\u00e9thodes et \u00e0 de nouveaux outils, c\u2019est d\u00e9cider de reprendre le contr\u00f4le et tourner d\u00e9finitivement le dos \u00e0 l\u2019imp\u00e9ratif fonctionnel si bien d\u00e9crit par <span class=\"citation\" data-cites=\"vitali-rosati_eloge_2024\">Vitali-Rosati (<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_vita2024a\">2024a<\/a>)<\/span>.<\/p>\n<blockquote><p>\u00ab\u00a0La technologie nous promet de nous rendre libres en nous d\u00e9livrant de toutes les t\u00e2ches ennuyeuses, triviales, r\u00e9p\u00e9titives, purement mat\u00e9rielles, en nous fournissant des &lsquo;solutions&rsquo; de plus en plus performantes, simples, intuitives, rapides et efficaces. Les GAFAM<a class=\"footnote\" title=\"Pour Google, Amazon, Facebook, Apple et Microsoft.\" id=\"return-footnote-4-3\" href=\"#footnote-4-3\" aria-label=\"Footnote 3\"><sup class=\"footnote\">[3]<\/sup><\/a> nous font r\u00eaver d\u2019un monde qui fonctionne tout seul, d\u2019un monde o\u00f9 nous sommes pris\u00b7es en charge jusqu\u2019\u00e0 nos identit\u00e9s par un petit nombre de compagnies priv\u00e9es. Mais cette d\u00e9livrance se fait au prix d\u2019une perte totale d\u2019autonomie, avec une d\u00e9pendance compl\u00e8te \u00e0 ces technologies et \u00e0 ces entreprises\u00a0\u00bb <span class=\"citation\" data-cites=\"vitali-rosati_eloge_2024\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_vita2024a\">Vitali-Rosati, 2024a<\/a>)<\/span>.<\/p><\/blockquote>\n<p>Adopter Markdown est un choix qui ne va pas n\u00e9cessairement de soi. Il y a, dans un premier temps, des t\u00e2tonnements, des pertes de temps pour r\u00e9soudre un probl\u00e8me particulier, des renoncements mais, \u00e0 l\u2019arriv\u00e9e, le gain de temps et de libert\u00e9 est \u00e9vident.<\/p>\n<blockquote><p>\u00ab\u00a0Il faut reconna\u00eetre que la production des documents \u00e0 partir du Markdown en conjonction de <em>Pandoc<\/em> demande dans un premier temps un certain investissement, en tout cas une motivation quotidienne, et peut-\u00eatre quelque chose d\u2019une r\u00e9solution ind\u00e9fectible. Cet investissement nous semble pourtant la contrepartie indispensable dont on doit s\u2019acquitter dans le dessein de s\u2019approprier, au sens de faire sien, ce qu\u2019est devenu l\u2019\u00e9crit dans notre soci\u00e9t\u00e9 aujourd\u2019hui\u00a0\u00bb <span class=\"citation\" data-cites=\"dehut_en_2018\">(<a href=\"https:\/\/e-publish.uliege.be\/md2\/back-matter\/bibliograhie#ref_dehu2018\">Dehut, 2018<\/a>).<\/span><\/p><\/blockquote>\n<hr class=\"before-footnotes clear\" \/><div class=\"footnotes\"><ol><li id=\"footnote-4-1\"><a href=\"https:\/\/e-publish.uliege.be\/md\" target=\"_blank\" rel=\"noopener\">https:\/\/e-publish.uliege.be\/md<\/a> <a href=\"#return-footnote-4-1\" class=\"return-footnote\" aria-label=\"Return to footnote 1\">&crarr;<\/a><\/li><li id=\"footnote-4-2\">Dans ce manuel, nous utiliserons l'expression \"Pandoc-Markdown\" pour d\u00e9signer la variante <em>Pandoc<\/em> de Markdown. <a href=\"#return-footnote-4-2\" class=\"return-footnote\" aria-label=\"Return to footnote 2\">&crarr;<\/a><\/li><li id=\"footnote-4-3\">Pour <em>Google, Amazon, Facebook, Apple<\/em> et <em>Microsoft<\/em>. <a href=\"#return-footnote-4-3\" class=\"return-footnote\" aria-label=\"Return to footnote 3\">&crarr;<\/a><\/li><\/ol><\/div>","protected":false},"author":2,"menu_order":1,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"front-matter-type":[12],"contributor":[],"license":[],"class_list":["post-4","front-matter","type-front-matter","status-publish","hentry","front-matter-type-introduction"],"_links":{"self":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter\/4"}],"collection":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter"}],"about":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/types\/front-matter"}],"author":[{"embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":30,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter\/4\/revisions"}],"predecessor-version":[{"id":993,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter\/4\/revisions\/993"}],"metadata":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter\/4\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/media?parent=4"}],"wp:term":[{"taxonomy":"front-matter-type","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/front-matter-type?post=4"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/contributor?post=4"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/license?post=4"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}