> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibedoc-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Blocks

> Comprehensive guide to all block types and how to use them effectively

## 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)

<Tabs>
  <Tab title="When to Use">
    * H1: Document title (once per document)
    * H2: Major sections
    * H3: Subsections
    * H4: Minor sections
    * H5: Detail sections
    * H6: Fine print or notes
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Add a heading: Financial Overview"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Heading
    3. Choose level (H1-H6)
    4. Type text
  </Tab>

  <Tab title="Customization">
    **Template Settings:**

    * Font size for each level
    * Line height
    * Font weight
    * Color
    * Spacing above/below

    **Individual:**

    * Text content only
    * Level can be changed after creation
  </Tab>
</Tabs>

**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

<Check>
  **Good:** "Q4 2024 Financial Results"
  **Bad:** "Section 4" or "Information"
</Check>

***

### Text Block

**Purpose:** Standard paragraph content

**Features:** Rich text with inline formatting

<Tabs>
  <Tab title="When to Use">
    * Body paragraphs
    * Descriptions
    * Explanations
    * Introductions
    * Conclusions
    * Any prose content
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Write a paragraph about our company mission"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Text
    3. Type or paste content
  </Tab>

  <Tab title="Formatting">
    **Inline Styles:**

    * **Bold:** `Cmd/Ctrl + B`
    * *Italic:* `Cmd/Ctrl + I`
    * Multiple paragraphs supported
    * Auto-spacing between blocks
  </Tab>
</Tabs>

**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

<Tip>
  For readability, split text into multiple blocks rather than one giant block.
</Tip>

***

### List Block

**Purpose:** Present items in bullet or numbered format

**Types:** Ordered (numbered) or Unordered (bullets)

<Tabs>
  <Tab title="When to Use">
    **Bullet Lists:**

    * Features
    * Benefits
    * Requirements
    * Options
    * Unordered collections

    **Numbered Lists:**

    * Steps or procedures
    * Ranked items
    * Sequential information
    * Priorities
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Create a bulleted list of key features"
    "Add numbered steps for the process"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select List
    3. Choose bullet or numbered
    4. Add items (Enter for new item)
  </Tab>

  <Tab title="Editing">
    * Click to edit any item
    * Press Enter to add new item
    * Press Backspace on empty item to remove
    * Drag items to reorder (coming soon)
  </Tab>
</Tabs>

**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:**

```markdown theme={null}
• Automated document generation with AI
• Professional templates and styling
• Seamless PDF export and sharing
• Real-time collaboration features
```

**Example - Good Numbered List:**

```markdown theme={null}
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

<Tabs>
  <Tab title="When to Use">
    * Pricing comparisons
    * Feature matrices
    * Schedules and timelines
    * Financial data
    * Specifications
    * Any structured data
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Create a table showing project milestones
    with columns for Phase, Duration, and Deliverables"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Table
    3. Define columns (headers)
    4. Add rows
    5. Populate cells
  </Tab>

  <Tab title="Editing">
    * Click any cell to edit
    * Tab to move to next cell
    * Add row: button at bottom
    * Add column: edit headers
    * Delete row: row menu
  </Tab>
</Tabs>

**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:**

| Feature     | Free     | Pro       | Enterprise |
| ----------- | -------- | --------- | ---------- |
| Documents   | 10/month | Unlimited | Unlimited  |
| AI Credits  | 50       | 300       | Custom     |
| PDF Exports | 5/month  | Unlimited | Unlimited  |
| Support     | Email    | Priority  | Dedicated  |

<Warning>
  Very large tables (>50 rows) may slow performance. Consider splitting or using attachments.
</Warning>

***

### Callout Block

**Purpose:** Highlight important information with colored boxes

**Types:** Info (blue), Warning (amber), Success (green), Error (red)

<Tabs>
  <Tab title="When to Use">
    **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
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Add a warning callout about the deadline"
    "Create an info box explaining the process"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Callout
    3. Choose type (info, warning, etc.)
    4. Add optional title
    5. Write body text
  </Tab>

  <Tab title="Customization">
    * Title (optional but recommended)
    * Body text
    * Icon (auto-set by type)
    * Color scheme (auto-set by type)
  </Tab>
</Tabs>

**Examples:**

<Info>
  **Pro Tip:** Use keyboard shortcuts to speed up your workflow. Press `Cmd+K` to see all shortcuts.
</Info>

<Warning>
  **Important:** Always save your work before closing the browser. Auto-save works but manual saves ensure nothing is lost.
</Warning>

<Check>
  **Best Practice:** Review your document in Preview mode before exporting to catch any formatting issues.
</Check>

**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

<Tabs>
  <Tab title="When to Use">
    * Contracts and agreements
    * Proposals requiring approval
    * Formal letters
    * Certificates
    * Official documents
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Add signature blocks for both parties"
    "Include signature section for client approval"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Signature
    3. Fill in fields:
       * Name
       * Role/Title
       * Company
       * Date
    4. Toggle "Signed" status
  </Tab>

  <Tab title="Fields">
    **Required:**

    * Name

    **Optional:**

    * Role/Title
    * Company
    * Date
    * Signed indicator (checkbox)
  </Tab>
</Tabs>

**Display:**

```
━━━━━━━━━━━━━━━━━━
John Smith
Chief Executive Officer
Acme Corporation
January 15, 2025
✓ Signed
━━━━━━━━━━━━━━━━━━
```

<Note>
  Signature blocks are visual representations only. For legally binding e-signatures, integrate with DocuSign or Adobe Sign.
</Note>

**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

<Tabs>
  <Tab title="When to Use">
    * Separate major sections
    * Before/after important blocks
    * Break up long content
    * Create visual rhythm
    * End of document
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Add a divider line"
    "Insert a separator before the conclusion"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Divider
    3. Choose style
  </Tab>

  <Tab title="Styles">
    * **Simple:** ─────────
    * **Double:** ═════════
    * **Dotted:** · · · · · ·
    * **Thick:** ━━━━━━━
  </Tab>
</Tabs>

**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

<Tabs>
  <Tab title="When to Use">
    * Document creation/update dates
    * Deadlines and due dates
    * Event dates
    * Expiration dates
    * Effective dates
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Show today's date"
    "Add deadline: March 31, 2025"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Date
    3. Pick date from calendar
    4. Choose format
  </Tab>

  <Tab title="Formats">
    * **Long:** January 15, 2025
    * **Medium:** Jan 15, 2025
    * **Short:** 01/15/2025
    * **ISO:** 2025-01-15
  </Tab>
</Tabs>

**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

<Tabs>
  <Tab title="When to Use">
    * Todo lists
    * Requirements checklists
    * Pre-flight checks
    * Quality assurance steps
    * Meeting agendas with action items
  </Tab>

  <Tab title="How to Add">
    **Via AI:**

    ```plaintext theme={null}
    "Create a checklist of project requirements"
    "Add todo items for the launch plan"
    ```

    **Manually:**

    1. Click + Add Block
    2. Select Checkbox
    3. Add items
    4. Click boxes to toggle
  </Tab>

  <Tab title="Interaction">
    * Click checkbox to mark complete
    * Click again to uncheck
    * Edit text of any item
    * Add new items (Enter key)
  </Tab>
</Tabs>

**Display:**

* [ ] Incomplete task
* [x] Completed task

**Best Practices:**

* Group related items together
* Use clear, actionable descriptions
* Mark items as you complete them
* Review unchecked items before finalizing

<Tip>
  Checkbox blocks are great for internal documents and project management, but consider converting to regular lists for client-facing documents.
</Tip>

***

### Image Block *(Coming Soon)*

**Purpose:** Embed images and graphics

**Formats:** JPG, PNG, SVG, GIF

<Note>
  Image blocks are in development. Current workaround: Use external image hosting and share links.
</Note>

**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)**
   ```plaintext theme={null}
   "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"

<Warning>
  Deleted blocks cannot be recovered. Consider duplicating important blocks before deleting.
</Warning>

## 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

<AccordionGroup>
  <Accordion icon="lightbulb" title="Use AI for Bulk Creation">
    Instead of adding blocks one by one, describe the entire structure to AI:

    ```plaintext theme={null}
    "Create a full project proposal with executive summary,
    objectives, timeline (as table), budget (as table),
    terms section, and signature blocks"
    ```
  </Accordion>

  <Accordion icon="lightbulb" title="Templates for Consistency">
    Create a template with your preferred block styles, then reuse for similar documents.
  </Accordion>

  <Accordion icon="lightbulb" title="Preview Frequently">
    Switch to Preview mode often to see how blocks look in final output.
  </Accordion>

  <Accordion icon="lightbulb" title="Mobile Editing">
    Most blocks work on mobile, but complex tables are easier to edit on desktop.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Creating Documents" icon="file-plus" href="/guides/creating-documents">
    Full document creation guide
  </Card>

  <Card title="Templates" icon="palette" href="/features/templates">
    Style your blocks
  </Card>

  <Card title="AI Creation" icon="sparkles" href="/features/ai-creation">
    Generate blocks with AI
  </Card>

  <Card title="Export" icon="file-export" href="/features/export">
    Export block documents
  </Card>
</CardGroup>