Skip to content

Powered by Grav

Tables

Tables

Helios provides clean, responsive table styling for presenting data in your documentation.

Basic Tables

Use standard markdown table syntax:

Feature Description Status
Dark Mode System preference with manual toggle Available
Search Full-text search with keyboard shortcuts Available
Versioning Folder-based documentation versions Available
API Docs Method badges and parameter tables Available
MARKDOWN
| Feature | Description | Status |
|---------|-------------|--------|
| Dark Mode | System preference with manual toggle | Available |
| Search | Full-text search with keyboard shortcuts | Available |

Column Alignment

Control column alignment with colons in the separator:

Left-aligned Center-aligned Right-aligned
Text Text Text
More text More text More text
Even more Even more Even more
MARKDOWN
| Left-aligned | Center-aligned | Right-aligned |
|:-------------|:--------------:|--------------:|

Wide Tables

Wide tables automatically scroll horizontally on small screens:

Parameter Type Required Default Description
email string Yes - User's email address
name string Yes - Display name
password string Yes - Password (min 8 chars)
role string No user User role (admin, user, viewer)
team_id string No null Team to assign user to
send_invite boolean No true Send invitation email

Striped Tables

Add the striped class for alternating row colors:

| Method | Endpoint | Description | |--------|----------|-------------| | GET | `/users` | List all users | | GET | `/users/{id}` | Get single user | | POST | `/users` | Create user | | PUT | `/users/{id}` | Update user | | DELETE | `/users/{id}` | Delete user |

Compact Tables

Use the compact class for denser tables:

| Code | Status | Meaning | |------|--------|---------| | 200 | OK | Request succeeded | | 201 | Created | Resource created | | 400 | Bad Request | Invalid input | | 401 | Unauthorized | Invalid credentials | | 404 | Not Found | Resource not found | | 500 | Server Error | Internal error |

Tables with Code

Tables can contain inline code:

Option Type Example
enabled boolean true
debug boolean false
theme string "default"
port number 3000

Complex Tables

For more complex tables, use HTML:

Feature Free Pro Enterprise
Users 5 50 Unlimited
Storage 1 GB 100 GB Unlimited
API Requests 1,000/day 50,000/day Unlimited
Support Community Email 24/7 Priority

Responsive Behavior

On mobile devices, wide tables become horizontally scrollable. The table header remains visible while scrolling.

Test this by resizing your browser window.

Styling Tables

Customize table styles in your CSS:

CSS
/* Custom table styling */
.prose table {
    @apply text-sm;
}

.prose th {
    @apply bg-primary text-white;
}

.prose td {
    @apply border-gray-200 dark:border-gray-700;
}

Best Practices

  1. Keep it simple - Use tables for tabular data, not layout
  2. Align numbers right - Makes comparison easier
  3. Use consistent formatting - Same data types should look the same
  4. Add headers - Always include a header row
  5. Keep cells concise - Long content should be in paragraphs, not tables

© 2025 Grav. All rights reserved.