{"id":2132,"date":"2026-05-26T06:46:41","date_gmt":"2026-05-26T06:46:41","guid":{"rendered":"https:\/\/www.vpascode.com\/de\/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\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/","title":{"rendered":"Grundlagen der PlantUML-Syntax"},"content":{"rendered":"<p>Bevor Sie in spezifische architektonische Layouts wie C4-Modelle oder Ablaufdiagramme eintauchen, ist es unerl\u00e4sslich, die grundlegenden Regeln zu verstehen, die die<strong>PlantUML-Handbuch<\/strong>. PlantUML basiert auf einem sauberen, hochintuitiven Textnotationssystem. Sobald Sie verstehen, wie der Engine Dokumente \u00f6ffnet, strukturelle Komponenten benennt und Verbindungslinien routet, wird das Erstellen jedes komplexen Systemlayouts v\u00f6llig nat\u00fcrlich.<\/p>\n<p>Dieser kurze \u00dcberblick behandelt die globalen strukturellen Syntaxmechanismen, die fast f\u00fcr jeden PlantUML-Diagrammtyp innerhalb der VPasCode-Arbeitsumgebung gelten.<\/p>\n<h2>1. Die obligatorischen Dokumentenwrapper<\/h2>\n<p>Jeder einzelne Block von PlantUML-Code muss mit expliziten Framework-Tags beginnen und enden. Diese Tags informieren den VPasCode-Parser, den richtigen Rendering-Engine in Ihrer Vorschaufl\u00e4che zu aktivieren:<\/p>\n<ul>\n<li><code>@startuml<\/code> \u2014 Diese genaue Zeile muss an den absoluten Anfang Ihres Skripts gesetzt werden. Es sollte nichts davor stehen.<\/li>\n<li><code>@enduml<\/code> \u2014 Diese genaue Zeile muss an das absolute Ende Ihres Skripts gesetzt werden und markiert das Ende Ihres Diagrammdatenblocks.<\/li>\n<\/ul>\n<p>Jeder Code, der au\u00dferhalb dieser beiden Marker geschrieben wird, wird vom Compiler sicher ignoriert oder kann eine Syntax-Validierungs-Warnung in Ihrer Arbeitsbereichs-Diagnoseleiste ausl\u00f6sen.<\/p>\n<h2>2. Deklaration von Elementen: IDs im Vergleich zu Anzeigetexten<\/h2>\n<p>Beim Modellieren eines Softwaresystems erstellen Sie verschiedene strukturelle Elemente wie Komponenten, Datenbanken, Akteure oder Mikrodienste. In PlantUML k\u00f6nnen Sie ein Element explizit deklarieren, indem Sie dessen Typ, eine interne Kurz-ID und einen benutzerfreundlichen Anzeigetext in Anf\u00fchrungszeichen definieren:<\/p>\n<pre><code>component microservice_id als \"Zahlungsverarbeitungs-API\"\r\ndatabase db_id als \"Benutzertransaktions-SQL\"<\/code><\/pre>\n<p><strong>Warum dies eine Best-Practice-Methode ist:<\/strong> Die Verwendung einer kurzen, sauberen internen ID (wie<code>microservice_id<\/code>) macht das Zeichnen von Beziehungslinien sp\u00e4ter deutlich schneller. Wenn Sie jemals den Kunden-facing-Label von \u201eZahlungsverarbeitungs-API\u201c auf \u201eGlobaler Kassen-Service\u201c \u00e4ndern m\u00fcssen, m\u00fcssen Sie dies nur in einer einzigen Codezeile bearbeiten, anstatt Dutzende von Zeilen in Ihrem Skript zu aktualisieren.<\/p>\n<h2>3. Beherrschen von Beziehungspfeilen und gerichteter Routing-Steuerung<\/h2>\n<p>Verbindungen zwischen Systemknoten werden mit Kombinationen von Strichen (<code>-<\/code>) und Pfeilklammern (<code>&gt;<\/code>). Die L\u00e4nge Ihrer Striche und die Einbeziehung von Richtungsschl\u00fcsselw\u00f6rtern geben Ihnen implizite Kontrolle dar\u00fcber, wie der automatisierte Layout-Engine Ihr Diagramm skaliert:<\/p>\n<ul>\n<li><strong>Grundverbindungen:<\/strong> <code>A --&gt; B<\/code>zeichnet einen standardm\u00e4\u00dfigen gerichteten Pfeil, der von Element A direkt zu Element B zeigt.<\/li>\n<li><strong>Punktierte Abh\u00e4ngigkeitslinien:<\/strong> Die Ersetzung von Strichen durch Punkte erzeugt eine punktierte Linie, die als Branchenstandard f\u00fcr die Kennzeichnung asynchroner Abh\u00e4ngigkeiten oder Netzwerkaufrufe gilt:<code>A ..&gt; B<\/code>.<\/li>\n<li><strong>Layout-Ausrichtung erzwingen:<\/strong> W\u00e4hrend der Layout-Engine die Boxen automatisch verteilt, k\u00f6nnen Sie die Ausrichtung explizit steuern, indem Sie einen Richtungswort direkt in die Pfeilzeichenfolge einf\u00fcgen:\n<ul>\n<li><code>A -up-&gt; B<\/code> (Zwingt B dazu, \u00fcber A gerendert zu werden)<\/li>\n<li><code>A -down-&gt; B<\/code> (Zwingt B dazu, unter A gerendert zu werden)<\/li>\n<li><code>A -left-&gt; B<\/code> (Zwingt B dazu, links von A gerendert zu werden)<\/li>\n<li><code>A -right-&gt; B<\/code> (Zwingt B dazu, rechts von A gerendert zu werden)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>4. Inline-Kontext hinzuf\u00fcgen: Beschriftungen und Codekommentare<\/h2>\n<p>Klare Dokumentation beruht stark darauf, angemessenen Kontext um Ihre visuellen Linien und Textskripte zu setzen:<\/p>\n<h3>Verbindungsleitungen beschriften<\/h3>\n<p>Sie k\u00f6nnen erkl\u00e4renden Text direkt zu jeder Verbindungsleitung hinzuf\u00fcgen, indem Sie einen Doppelpunkt (&#8220;<code>:<\/code>) direkt nach Ihrer Beziehungskennzeichnung anf\u00fcgen:<\/p>\n<pre><code>client_id --&gt; api_id : \"HTTPS POST \/v1\/checkout\"<\/code><\/pre>\n<h3>Codekommentare schreiben<\/h3>\n<p>Wenn Sie eine administrative Notiz, ein Design-Credit oder eine architektonische Erkl\u00e4rung innerhalb Ihrer Skriptdatei hinterlassen m\u00f6chten, ohne dass eine visuelle Box auf der Leinwand gerendert wird, verwenden Sie ein einfaches Anf\u00fchrungszeichen (&#8220;<code>'<\/code>). Dadurch teilt die Engine dem Parser mit, diese Zeile vollst\u00e4ndig zu \u00fcberspringen:<\/p>\n<pre><code>' TODO: Wir m\u00fcssen diese Grenzbox aktualisieren, sobald die DevOps-Migration abgeschlossen ist\r\n[Legacy Monolith] --&gt; [Neues Microservice]<\/code><\/pre>\n<p>Da Sie nun mit den globalen Syntaxumwicklungen, Komponentendeklarationen und Richtungspfeilparametern von PlantUML vertraut sind, sind Sie bestens ger\u00fcstet, um fortgeschrittene Systemformen zu erstellen. Gehen Sie zur n\u00e4chsten Seite, um unsere Sammlung von <strong>Architektur- und Hoch-Level-Entwurfsdiagrammen<\/strong>!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Bevor Sie in spezifische architektonische Layouts wie C4-Modelle oder Ablaufdiagramme eintauchen, ist es unerl\u00e4sslich, die grundlegenden Regeln zu verstehen, die diePlantUML-Handbuch. PlantUML basiert auf einem sauberen, hochintuitiven Textnotationssystem. Sobald Sie verstehen, wie der Engine Dokumente \u00f6ffnet, strukturelle Komponenten benennt und&#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-2132","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\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/\" \/>\n<meta property=\"og:locale\" content=\"de_DE\" \/>\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\/de\/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=\"Gesch\u00e4tzte Lesezeit\" \/>\n\t<meta name=\"twitter:data1\" content=\"3\u00a0Minuten\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"name\":\"PlantUML Syntax Basics | VPasCode Text to Diagram Guide\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#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\\\/de\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\"},\"inLanguage\":\"de\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.vpascode.com\\\/de\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lean Docs\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/docs\\\/%ld_collection%\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Grundlagen der PlantUML-Syntax\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#website\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/\",\"name\":\"VPasCode\",\"description\":\"by Visual Paradigm\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"de\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#organization\",\"name\":\"VPasCode\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"de\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/wp-content\\\/uploads\\\/sites\\\/4\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"contentUrl\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/wp-content\\\/uploads\\\/sites\\\/4\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"width\":128,\"height\":138,\"caption\":\"VPasCode\"},\"image\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/de\\\/#\\\/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\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_locale":"de_DE","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\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_site_name":"VPasCode","twitter_card":"summary_large_image","twitter_misc":{"Gesch\u00e4tzte Lesezeit":"3\u00a0Minuten"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.vpascode.com\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/","url":"https:\/\/www.vpascode.com\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/","name":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","isPartOf":{"@id":"https:\/\/www.vpascode.com\/de\/#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\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb"},"inLanguage":"de","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.vpascode.com\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.vpascode.com\/de\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.vpascode.com\/de\/"},{"@type":"ListItem","position":2,"name":"Lean Docs","item":"https:\/\/www.vpascode.com\/de\/docs\/%ld_collection%\/"},{"@type":"ListItem","position":3,"name":"Grundlagen der PlantUML-Syntax"}]},{"@type":"WebSite","@id":"https:\/\/www.vpascode.com\/de\/#website","url":"https:\/\/www.vpascode.com\/de\/","name":"VPasCode","description":"by Visual Paradigm","publisher":{"@id":"https:\/\/www.vpascode.com\/de\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.vpascode.com\/de\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"de"},{"@type":"Organization","@id":"https:\/\/www.vpascode.com\/de\/#organization","name":"VPasCode","url":"https:\/\/www.vpascode.com\/de\/","logo":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/www.vpascode.com\/de\/#\/schema\/logo\/image\/","url":"https:\/\/www.vpascode.com\/de\/wp-content\/uploads\/sites\/4\/2026\/06\/cropped-vp-online-logo-v1.png","contentUrl":"https:\/\/www.vpascode.com\/de\/wp-content\/uploads\/sites\/4\/2026\/06\/cropped-vp-online-logo-v1.png","width":128,"height":138,"caption":"VPasCode"},"image":{"@id":"https:\/\/www.vpascode.com\/de\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/ld_docs\/2132","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/ld_docs"}],"about":[{"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/types\/ld_docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/users\/4"}],"wp:attachment":[{"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/media?parent=2132"}],"wp:term":[{"taxonomy":"ld_collection","embeddable":true,"href":"https:\/\/www.vpascode.com\/de\/wp-json\/wp\/v2\/ld_collection?post=2132"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}