Skip to main content

​
Introduction

Blocks are the building components of VibeDoc documents. Each block represents a specific type of content with its own formatting and behavior. This guide covers all block types and how to use them effectively.

​
Block Types Reference

​
Heading Block

Purpose: Create document structure and hierarchy Levels: H1 (largest) through H6 (smallest)
  • H1: Document title (once per document)
  • H2: Major sections
  • H3: Subsections
  • H4: Minor sections
  • H5: Detail sections
  • H6: Fine print or notes
Best Practices:
  • Use only one H1 per document
  • Don’t skip levels (H1 → H3)
  • Keep headings concise (3-7 words)
  • Make them descriptive, not generic
Good: “Q4 2024 Financial Results” Bad: “Section 4” or “Information”

​
Text Block

Purpose: Standard paragraph content Features: Rich text with inline formatting
  • Body paragraphs
  • Descriptions
  • Explanations
  • Introductions
  • Conclusions
  • Any prose content
Best Practices:
  • Keep paragraphs focused on one idea
  • Aim for 3-5 sentences per block
  • Use bold sparingly for emphasis
  • Break up long text with headings
For readability, split text into multiple blocks rather than one giant block.

​
List Block

Purpose: Present items in bullet or numbered format Types: Ordered (numbered) or Unordered (bullets)
Bullet Lists:
  • Features
  • Benefits
  • Requirements
  • Options
  • Unordered collections
Numbered Lists:
  • Steps or procedures
  • Ranked items
  • Sequential information
  • Priorities
Best Practices:
  • Parallel structure (all items similar format)
  • Start each item with capital letter
  • No periods unless complete sentences
  • Keep items concise (one line ideally)
  • 5-7 items maximum per list
Example - Good Bullet List: 
• Automated document generation with AI
• Professional templates and styling
• Seamless PDF export and sharing
• Real-time collaboration features
Example - Good Numbered List: 
1. Sign up for free account
2. Create your first document
3. Customize with templates
4. Export and share

​
Table Block

Purpose: Display structured data in rows and columns Components: Headers + Data Rows
  • Pricing comparisons
  • Feature matrices
  • Schedules and timelines
  • Financial data
  • Specifications
  • Any structured data
Best Practices:
  • Keep headers short and clear
  • Align numbers right, text left
  • Don’t exceed 6-7 columns (readability)
  • Use consistent formatting in cells
  • Consider landscape orientation for wide tables
Example Table:
FeatureFreeProEnterprise
Documents10/monthUnlimitedUnlimited
AI Credits50300Custom
PDF Exports5/monthUnlimitedUnlimited
SupportEmailPriorityDedicated
Very large tables (>50 rows) may slow performance. Consider splitting or using attachments.

​
Callout Block

Purpose: Highlight important information with colored boxes Types: Info (blue), Warning (amber), Success (green), Error (red)
Info (Blue):
  • Helpful tips
  • Additional context
  • References
Warning (Amber):
  • Cautions
  • Important notes
  • Limitations
Success (Green):
  • Best practices
  • Confirmations
  • Positive outcomes
Error (Red):
  • Critical warnings
  • Errors to avoid
  • Urgent information
Examples:
Pro Tip: Use keyboard shortcuts to speed up your workflow. Press Cmd+K to see all shortcuts.
Important: Always save your work before closing the browser. Auto-save works but manual saves ensure nothing is lost.
Best Practice: Review your document in Preview mode before exporting to catch any formatting issues.
Best Practices:
  • Use sparingly (1-2 per page max)
  • Always include a title
  • Keep body text brief
  • Choose appropriate type
  • Don’t nest multiple callouts

​
Signature Block

Purpose: Professional signature sections for agreements Components: Name, Role, Company, Date, Signature Line
  • Contracts and agreements
  • Proposals requiring approval
  • Formal letters
  • Certificates
  • Official documents
Display: 
━━━━━━━━━━━━━━━━━━
John Smith
Chief Executive Officer
Acme Corporation
January 15, 2025
✓ Signed
━━━━━━━━━━━━━━━━━━
Signature blocks are visual representations only. For legally binding e-signatures, integrate with DocuSign or Adobe Sign.
Best Practices:
  • Include all parties to agreement
  • Pre-fill your company’s details
  • Leave client fields empty for them to complete
  • Set current date when finalizing
  • Use multiple signature blocks side-by-side for multiple signers

​
Divider Block

Purpose: Visual separation between sections Styles: Simple line, double line, dotted, thick
  • Separate major sections
  • Before/after important blocks
  • Break up long content
  • Create visual rhythm
  • End of document
Best Practices:
  • Don’t overuse (max 3-4 per document)
  • Place between major sections, not subsections
  • Use consistent style throughout document
  • Avoid placing directly under headings

​
Date Block

Purpose: Display formatted dates Formats: Long, Medium, Short, ISO
  • Document creation/update dates
  • Deadlines and due dates
  • Event dates
  • Expiration dates
  • Effective dates
Best Practices:
  • Use consistent format throughout document
  • Long format for formal documents
  • Short format for data-heavy docs
  • ISO format for technical/international docs

​
Checkbox Block

Purpose: Interactive task lists and checklists State: Checked or Unchecked
  • Todo lists
  • Requirements checklists
  • Pre-flight checks
  • Quality assurance steps
  • Meeting agendas with action items
Display:
  • Incomplete task
  • Completed task
Best Practices:
  • Group related items together
  • Use clear, actionable descriptions
  • Mark items as you complete them
  • Review unchecked items before finalizing
Checkbox blocks are great for internal documents and project management, but consider converting to regular lists for client-facing documents.

​
Image Block (Coming Soon)

Purpose: Embed images and graphics Formats: JPG, PNG, SVG, GIF
Image blocks are in development. Current workaround: Use external image hosting and share links.
Planned Features:
  • Drag-and-drop upload
  • Resize and crop
  • Alignment (left, center, right)
  • Captions
  • Alt text for accessibility
  • Image galleries

​
Block Management

​
Adding Blocks

Three methods:
  1. AI Chat (Recommended) 
    "Add a table showing quarterly results"
"Insert a warning callout about the deadline"
  2. + Add Block Button
    • Click button between blocks
    • Select from menu
    • Configure and add
  3. Keyboard Shortcuts (coming soon)
    • /heading → Heading block
    • /text → Text block
    • /list → List block

​
Reordering Blocks

Drag & Drop:
  1. Hover over block
  2. Click and hold drag handle (⋮⋮)
  3. Drag to new position
  4. Release to drop
Keyboard: (coming soon)
  • Cmd/Ctrl + Up → Move block up
  • Cmd/Ctrl + Down → Move block down

​
Duplicating Blocks

Methods:
  • Click duplicate icon in block toolbar
  • Cmd/Ctrl + D (coming soon)
  • Via AI: “Duplicate the pricing table”

​
Deleting Blocks

Methods:
  • Click delete icon in block toolbar
  • Select block and press Delete key
  • Via AI: “Remove the budget section”
Deleted blocks cannot be recovered. Consider duplicating important blocks before deleting.

​
Advanced Techniques

​
Block Combinations

Create complex layouts by combining blocks: Example: Professional Proposal 
1. H1: Proposal Title
2. Text: Executive summary
3. Divider
4. H2: Objectives
5. List: Key objectives (bullets)
6. H2: Timeline
7. Table: Project phases with dates
8. Callout (Info): Important deadline note
9. H2: Budget
10. Table: Budget breakdown
11. H2: Terms
12. Text: Payment and terms
13. Divider
14. H2: Approval
15. Signature: Your company
16. Signature: Client

​
Responsive Design

Blocks automatically adapt to:
  • Different screen sizes
  • PDF export
  • Print media
  • Share pages
No configuration needed!

​
Block Styling

Some blocks inherit template styles:
  • Headings use template fonts and colors
  • Tables use template borders and spacing
  • Callouts use template accent colors

​
Tips & Tricks

Instead of adding blocks one by one, describe the entire structure to AI:
"Create a full project proposal with executive summary,
objectives, timeline (as table), budget (as table),
terms section, and signature blocks"
Create a template with your preferred block styles, then reuse for similar documents.
Switch to Preview mode often to see how blocks look in final output.
Most blocks work on mobile, but complex tables are easier to edit on desktop.

​
Next Steps

Creating Documents

Full document creation guide

Templates

Style your blocks

AI Creation

Generate blocks with AI

Export

Export block documents