← Back
Add Text Annotations
← Back to Academy

Add Text Annotations

Learn how to add text nodes to make your architecture diagrams clear and professional in just 3-4 minutes

basicsbeginner⏱️4 min
Home/Documentation/Add Text Annotations

Learn how to add text nodes to make your architecture diagrams clear and professional in just 3-4 minutes

Academy/
Add Text AnnotationsDocumentation

Add Text Annotations

Imagine this: You've created a beautiful architecture diagram with 20 services, but when your teammate looks at it, they ask "What does this section do?" Your diagram is technically correct but lacks context.

Your Journey Begins

Meet Alex: A developer who just built a complex microservices diagram. The services are all there, but without labels, no one understands the architecture. Sound familiar?

The Solution: Text Nodes

Text nodes are like sticky notes for your diagrams - simple, lightweight annotations that add titles, labels, and context exactly where you need them.

✗ Before: Unclear

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Services without context - hard to understand

✓ After: Crystal Clear

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Same diagram with text nodes - instantly understandable!

✨ The Power of Text Nodes

See the difference? Just two text nodes transformed a confusing diagram into professional documentation. That's what you'll learn today!

What You'll Master in 3-4 Minutes

Create

Add your first text node in seconds

Position

Place text strategically for maximum clarity

Style

Make text readable with smart color choices

Skill 1 of 3: Creation

Create Your First Text Node

Let's get hands-on immediately! Creating a text node takes just 4 clicks. Watch this simple demo:

Text Node Creation Demo

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Interactive

A simple text node ready for your content

Step-by-Step

•

Look at the floating action bar at the top and find the "Add text" button

•

Click it once - a text node appears on your canvas

•

Click where you want to place it

•

Click on it and type your text in the "Label" field on the right panel or on the node

Quick Creation

It's that simple! Text nodes appear instantly with default text "Text" - just edit and you're done. No complex setup needed.

Pro tip

You can create text nodes by pressing "t" on your keyboard as a shortcut! and you can also edit them directly on the canvas.

What Makes Text Nodes Special?

No Icons

Just pure text - perfect for labels and notes

Lightweight

Simpler than regular nodes - only 2 colors to customize

Instant

Ready to use in seconds, no configuration needed

Quick Guide

When to use what:

  • Text nodes → Titles, labels, notes, annotations
  • Regular nodes → Actual services, databases, APIs

What's the main difference between text nodes and regular nodes?

Text nodes are bigger
Text nodes have no icons - just text content
Text nodes are slower to create
Text nodes can't be moved
Skill 1 Complete

Great work! You've just learned how to create text nodes. That's 1 of 3 skills mastered!

Skill 2 of 3: Strategic Placement

Position Text Nodes Strategically

Now that Alex knows how to create text nodes, she needs to place them effectively. The secret? Position text close to what it describes.

✗ Poor Placement

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Interactive

Title far from content - confusing

✓ Smart Placement

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Interactive

Title above related services - clear!

Two Simple Rules

•

Group with Related Content

Place text nodes near the components they describe - titles above sections, notes beside services

•

Leave Breathing Room

Add spacing around text for readability - don't cram text right against nodes

Strategic Placement

Pro tip from Alex: She places titles at the top of each section and notes beside specific services. This creates natural visual grouping!

Moving Text Nodes

•

Click the text node to select it

•

Drag it to the new position

•

Release to place it - that's it!

Common Use Cases

Section Titles

Place at the top: "Frontend Layer", "Data Storage", "External APIs"

Annotations

Place beside nodes: "Legacy system", "Under development", "v2.0 only"

Environment Labels

Place in corners: "Production", "Staging", "Development"

Skill 2 Complete

Awesome progress! You now know where to place text for maximum clarity. That's 2 of 3 skills mastered! 🎯

Skill 3 of 3: Readable Styling

Style for Maximum Readability

Alex's diagram is looking great, but some text is hard to read. The final skill? Choose colors with good contrast. That's the secret to professional-looking diagrams.

The One Rule You Need

Contrast is Everything

The Golden Rule: Always use high contrast between text color and background.

Dark text + Light background

Light text + Dark background

Similar colors = unreadable!

✗ Poor Contrast

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Hard to read - avoid this!

✓ Good Contrast

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Easy to read - perfect!

Understanding the Two Colors

Stroke Color (Text Color)

The color of the text itself - make it stand out!

Fill Color (Background)

The background behind the text - use for emphasis or keep transparent

Text Size for Hierarchy

Use different sizes to create visual organization - larger for titles, smaller for notes.

Font Size Hierarchy

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Interactive

Drag these around to see how size creates hierarchy

Large (16-20px)

For main diagram titles and major section headers

Medium (12-14px)

For standard labels and subsection headers

Small (10-11px)

For annotations, notes, and detailed captions

Why is high contrast between text and background important?

It makes diagrams load faster
It ensures text is readable at any zoom level
It uses less memory
It looks more colorful
Skill 3 Complete

Fantastic! You've mastered the art of readable text styling. That's all 3 skills complete!

See the Full Picture

Alex's Success Story

Remember Alex's confusing diagram from the start? Here's her final result after applying everything you just learned:

Professional Architecture Diagram

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Interactive

Drag nodes around to explore! Notice the clear titles, strategic annotations, and readable styling.

Notice How Text Nodes Transform the Diagram:

Clear Hierarchy

Main title (18px) → Section headers (14px) → Notes (9-11px)

Visual Organization

Each section labeled with colored headers that group related services

Critical Context

Migration note and environment label provide essential information

Professional Appearance

High contrast colors make everything readable and polished

You Did It!

This is what you can create now! Just three simple skills - create, position, style - and you can turn any diagram from confusing to crystal clear.

Save This for Later

Quick Reference Guide

Bookmark this section for quick reminders when you're creating diagrams.

The 3 Essential Skills

**Create**: Click "Add text" → Type your label → Done in 4 clicks

**Position**: Place near related content + Leave breathing room

**Style**: Use high contrast (dark text + light bg or vice versa)

Text Size Guidelines

Large (16-20px) for main titles

Medium (12-14px) for section headers

Small (10-11px) for annotations and notes

Common Text Node Uses

Diagram titles: "User Management System"

Section headers: "Backend Services", "Data Layer"

Migration notes: "Legacy - Migrate Q1 2025"

Environment labels: "Production", "Staging"

Technical notes: "PostgreSQL 14", "REST API v2"

Keyboard Shortcuts

Handy Shortcuts

Create a new text node

t

Delete selected text node

Delete
Continue Your Journey

You're a Text Annotation Pro!

Congratulations! You've mastered a skill that will make every diagram you create clearer, more professional, and easier to understand.

Amazing Work!

What you accomplished today: Created text nodes in seconds Positioned them strategically for clarity
Styled them for maximum readability Transformed a confusing diagram into professional documentation

Remember: 🎯 Text nodes are like sticky notes - simple and powerful 📍 Position near what you're describing 🎨 High contrast = readable text 📏 Use size to show hierarchy

Level Up Your Skills

Pro tip: Try combining text nodes with freehand lines to create even more powerful annotations - arrows pointing to specific services with explanatory text!

3 of 10

Related Articles

5 m

Create Your First Node

Master the basics of node creation in ArkT diagrams

basicsbeginner
7 m

Edge Connections

Learn how to connect nodes with directional edges

basicsbeginner
6 m

Infinite Levels

Master multi-level diagrams and breadcrumb navigation

basicsbeginner

Practice with Tutorial

Apply what you've learned with an interactive, step-by-step tutorial.

View All Modules in Academy

On This Page

IntroductionPart 1: Create Your First Text NodePart 2: Position for ClarityPart 3: Make It ReadablePutting It All TogetherQuick ReferenceWhat's Next?