{"id":2133,"date":"2026-05-26T06:46:41","date_gmt":"2026-05-26T06:46:41","guid":{"rendered":"https:\/\/www.vpascode.com\/fr\/docs\/uncategorized\/plantuml-syntax-basics\/"},"modified":"2026-05-26T06:46:41","modified_gmt":"2026-05-26T06:46:41","slug":"plantuml-syntax-basics","status":"publish","type":"ld_docs","link":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/","title":{"rendered":"Bases de la syntaxe PlantUML"},"content":{"rendered":"<p>Avant de plonger dans des agencements architecturaux sp\u00e9cifiques comme les mod\u00e8les C4 ou les chronologies de s\u00e9quence, il est essentiel de comprendre les r\u00e8gles fondamentales qui r\u00e9gissent le <strong>Guide pratique PlantUML<\/strong>. PlantUML repose sur un syst\u00e8me de notation textuelle clair et tr\u00e8s intuitif. Une fois que vous comprenez comment le moteur ouvre les documents, nomme les composants structurels et route les lignes de connexion, la r\u00e9daction de tout agencement de syst\u00e8me complexe devient totalement naturelle.<\/p>\n<p>Ce bref aper\u00e7u couvre les m\u00e9caniques syntaxiques structurelles globales qui s&#8217;appliquent \u00e0 presque tous les types de diagrammes PlantUML dans l&#8217;environnement VPasCode.<\/p>\n<h2>1. Les enveloppes obligatoires du document<\/h2>\n<p>Chaque bloc de code PlantUML doit commencer et se terminer par des balises de cadre explicites. Ces balises indiquent au parseur VPasCode de d\u00e9marrer le moteur de rendu appropri\u00e9 dans votre canevas d&#8217;aper\u00e7u :<\/p>\n<ul>\n<li><code>@startuml<\/code> \u2014 Cette ligne exacte doit \u00eatre plac\u00e9e en tout premier lieu de votre script. Rien d&#8217;autre ne doit la pr\u00e9c\u00e9der.<\/li>\n<li><code>@enduml<\/code> \u2014 Cette ligne exacte doit \u00eatre plac\u00e9e en tout dernier lieu de votre script, marquant la fin de votre bloc de donn\u00e9es du diagramme.<\/li>\n<\/ul>\n<p>Tout code r\u00e9dig\u00e9 en dehors de ces deux rep\u00e8res sera ignor\u00e9 en toute s\u00e9curit\u00e9 par le compilateur, ou pourrait d\u00e9clencher un avertissement de validation syntaxique dans le panneau de diagnostic de votre espace de travail.<\/p>\n<h2>2. D\u00e9claration des \u00e9l\u00e9ments : ID vs. \u00e9tiquettes d&#8217;affichage<\/h2>\n<p>Lors de la mod\u00e9lisation d&#8217;un syst\u00e8me logiciel, vous cr\u00e9erez divers \u00e9l\u00e9ments structurels tels que des composants, des bases de donn\u00e9es, des acteurs ou des microservices. Dans PlantUML, vous pouvez d\u00e9clarer un \u00e9l\u00e9ment explicitement en d\u00e9finissant son type, un ID abr\u00e9g\u00e9 interne et un nom d&#8217;affichage convivial entour\u00e9 de guillemets :<\/p>\n<pre><code>composant microservice_id comme \"API de traitement des paiements\"\r\ndatabase db_id comme \"SQL des transactions utilisateur\"<\/code><\/pre>\n<p><strong>Pourquoi c&#8217;est une bonne pratique :<\/strong> Utiliser un ID interne court et clair (comme <code>microservice_id<\/code>) rend le dessin des lignes de relation beaucoup plus rapide par la suite. Si vous devez un jour modifier l&#8217;\u00e9tiquette visible par le client de \u00ab\u00a0API de traitement des paiements\u00a0\u00bb \u00e0 \u00ab\u00a0Service de paiement global\u00a0\u00bb, vous n&#8217;aurez qu&#8217;\u00e0 modifier cette ligne unique de code, plut\u00f4t que de mettre \u00e0 jour des dizaines de lignes dans tout votre script.<\/p>\n<h2>3. Ma\u00eetriser les fl\u00e8ches de relation et le routage directionnel<\/h2>\n<p>Les connexions entre les n\u0153uds du syst\u00e8me sont dessin\u00e9es \u00e0 l&#8217;aide de combinaisons de tirets (<code>-<\/code>) et de crochets fl\u00e9ch\u00e9s (<code>&gt;<\/code>). La longueur de vos tirets et l&#8217;inclusion de mots-cl\u00e9s directionnels vous donnent un contr\u00f4le implicite sur la mani\u00e8re dont le moteur de disposition automatis\u00e9 \u00e9chelonne votre diagramme :<\/p>\n<ul>\n<li><strong>Connexions de base :<\/strong> <code>A --&gt; B<\/code> dessine une fl\u00e8che dirig\u00e9e standard pointant de l&#8217;\u00e9l\u00e9ment A directement vers l&#8217;\u00e9l\u00e9ment B.<\/li>\n<li><strong>Lignes de d\u00e9pendance pointill\u00e9es :<\/strong> Remplacer les tirets par des points cr\u00e9e une ligne pointill\u00e9e, qui est la norme de l&#8217;industrie pour indiquer des d\u00e9pendances asynchrones ou des appels r\u00e9seau : <code>A ..&gt; B<\/code>.<\/li>\n<li><strong>Forcer l&#8217;orientation du layout :<\/strong> Bien que le moteur de mise en page place les bo\u00eetes automatiquement, vous pouvez explicitement contr\u00f4ler l&#8217;orientation en ins\u00e9rant un mot-cl\u00e9 de direction directement dans la cha\u00eene de fl\u00e8che :\n<ul>\n<li><code>A -up-&gt; B<\/code> (Force B \u00e0 s&#8217;afficher au-dessus de A)<\/li>\n<li><code>A -down-&gt; B<\/code> (Force B \u00e0 s&#8217;afficher en dessous de A)<\/li>\n<li><code>A -left-&gt; B<\/code> (Force B \u00e0 s&#8217;afficher \u00e0 gauche de A)<\/li>\n<li><code>A -right-&gt; B<\/code> (Force B \u00e0 s&#8217;afficher \u00e0 droite de A)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>4. Ajout de contexte en ligne : \u00e9tiquettes et commentaires de code<\/h2>\n<p>Une documentation claire repose fortement sur le fait de placer un contexte appropri\u00e9 autour de vos lignes visuelles et de vos scripts texte :<\/p>\n<h3>\u00c9tiquetage des lignes de connexion<\/h3>\n<p>Vous pouvez ajouter du texte explicatif directement sur n&#8217;importe quelle ligne de connexion en ajoutant deux points (&#8220;<code>:<\/code>) juste apr\u00e8s votre mappage de relation :<\/p>\n<pre><code>client_id --&gt; api_id : \"POST HTTPS \/v1\/checkout\"<\/code><\/pre>\n<h3>R\u00e9daction de commentaires de code<\/h3>\n<p>Si vous souhaitez laisser une note administrative, un cr\u00e9dit de conception ou une explication architecturale dans votre fichier de script sans afficher de bo\u00eete visuelle sur la toile, utilisez un caract\u00e8re d&#8217;apostrophe (&#8220;<code>'<\/code>). Cela indique au moteur de sauter compl\u00e8tement l&#8217;analyse de cette ligne :<\/p>\n<pre><code>' TODO : Nous devons mettre \u00e0 jour cette bo\u00eete de limite une fois la migration DevOps termin\u00e9e\r\n[Monolithe h\u00e9rit\u00e9] --&gt; [Nouveau microservice]<\/code><\/pre>\n<p>Maintenant que vous \u00eates familier avec les enveloppes de syntaxe globales, les d\u00e9clarations de composants et les param\u00e8tres de fl\u00e8ches directionnelles de PlantUML, vous \u00eates parfaitement \u00e9quip\u00e9 pour commencer \u00e0 cr\u00e9er des formes syst\u00e8me avanc\u00e9es. Passez \u00e0 la page suivante pour d\u00e9bloquer notre collection de <strong>Diagrammes d&#8217;architecture et de conception de haut niveau<\/strong>!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Avant de plonger dans des agencements architecturaux sp\u00e9cifiques comme les mod\u00e8les C4 ou les chronologies de s\u00e9quence, il est essentiel de comprendre les r\u00e8gles fondamentales qui r\u00e9gissent le Guide pratique PlantUML. PlantUML repose sur un syst\u00e8me de notation textuelle clair&#8230;<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"template":"","meta":{"inline_featured_image":false,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"ld_collection":[14],"class_list":["post-2133","ld_docs","type-ld_docs","status-publish","hentry","ld_collection-vpascode-docs"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>PlantUML Syntax Basics | VPasCode Text to Diagram Guide<\/title>\n<meta name=\"description\" content=\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PlantUML Syntax Basics | VPasCode Text to Diagram Guide\" \/>\n<meta property=\"og:description\" content=\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/\" \/>\n<meta property=\"og:site_name\" content=\"VPasCode\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"name\":\"PlantUML Syntax Basics | VPasCode Text to Diagram Guide\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#website\"},\"datePublished\":\"2026-05-26T06:46:41+00:00\",\"description\":\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lean Docs\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/docs\\\/%ld_collection%\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bases de la syntaxe PlantUML\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#website\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/\",\"name\":\"VPasCode\",\"description\":\"by Visual Paradigm\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#organization\",\"name\":\"VPasCode\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/wp-content\\\/uploads\\\/sites\\\/6\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"contentUrl\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/wp-content\\\/uploads\\\/sites\\\/6\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"width\":128,\"height\":138,\"caption\":\"VPasCode\"},\"image\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/fr\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_locale":"fr_FR","og_type":"article","og_title":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","og_description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","og_url":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_site_name":"VPasCode","twitter_card":"summary_large_image","twitter_misc":{"Dur\u00e9e de lecture estim\u00e9e":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/","url":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/","name":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","isPartOf":{"@id":"https:\/\/www.vpascode.com\/fr\/#website"},"datePublished":"2026-05-26T06:46:41+00:00","description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","breadcrumb":{"@id":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.vpascode.com\/fr\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.vpascode.com\/fr\/"},{"@type":"ListItem","position":2,"name":"Lean Docs","item":"https:\/\/www.vpascode.com\/fr\/docs\/%ld_collection%\/"},{"@type":"ListItem","position":3,"name":"Bases de la syntaxe PlantUML"}]},{"@type":"WebSite","@id":"https:\/\/www.vpascode.com\/fr\/#website","url":"https:\/\/www.vpascode.com\/fr\/","name":"VPasCode","description":"by Visual Paradigm","publisher":{"@id":"https:\/\/www.vpascode.com\/fr\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.vpascode.com\/fr\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/www.vpascode.com\/fr\/#organization","name":"VPasCode","url":"https:\/\/www.vpascode.com\/fr\/","logo":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/www.vpascode.com\/fr\/#\/schema\/logo\/image\/","url":"https:\/\/www.vpascode.com\/fr\/wp-content\/uploads\/sites\/6\/2026\/06\/cropped-vp-online-logo-v1.png","contentUrl":"https:\/\/www.vpascode.com\/fr\/wp-content\/uploads\/sites\/6\/2026\/06\/cropped-vp-online-logo-v1.png","width":128,"height":138,"caption":"VPasCode"},"image":{"@id":"https:\/\/www.vpascode.com\/fr\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/ld_docs\/2133","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/ld_docs"}],"about":[{"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/types\/ld_docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/users\/4"}],"wp:attachment":[{"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/media?parent=2133"}],"wp:term":[{"taxonomy":"ld_collection","embeddable":true,"href":"https:\/\/www.vpascode.com\/fr\/wp-json\/wp\/v2\/ld_collection?post=2133"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}