Full Layout Demo
On this page
This page demonstrates the complete MarkdownLayout with both sidebars enabled. You have project navigation on the left and table of contents on the right!
The full layout provides maximum navigation capabilities:
- Left sidebar: Quick access to all projects
- Right sidebar: Page navigation with scroll tracking
- Center content: Main documentation or article
Enable both features in your frontmatter:
---tableOfContents: trueshowSidebar: true---With both sidebars, users can:
- Switch between projects easily
- Navigate within the current page
- Keep context while reading
This layout is ideal for comprehensive documentation sites where users need to:
- Reference multiple projects
- Navigate long documents
- Maintain awareness of their location
The layout adapts gracefully to different screen sizes:
- All three columns visible
- Full navigation capabilities
- Project sidebar visible
- Table of contents hidden
- Content takes more space
- Both sidebars hidden
- Content takes full width
- Clean reading experience
When using the full layout, consider:
The main content area is narrower due to both sidebars. This actually improves readability by creating an optimal line length.
The sidebars create a balanced, symmetric layout that feels professional and organized.
Users can quickly understand:
- Where they are in the site (project sidebar)
- Where they are on the page (table of contents)
- What content is available
Perfect for:
- API documentation
- Multi-project documentation sites
- Technical references
- Learning resources
With full layout, ensure your content:
- Has clear heading hierarchy
- Uses descriptive section titles
- Maintains logical flow
- Includes relevant cross-references
Imagine documenting a suite of related tools:
- User lands on documentation for
tmuxp - Sees related projects in left sidebar
- Uses ToC to jump to specific features
- Easily switches to
libtmuxdocs when needed
This creates a seamless documentation experience!
Despite having multiple components, the layout remains performant:
- Sidebars use
position: stickyfor efficient scrolling - IntersectionObserver minimizes scroll event overhead
- Components are optimized for minimal re-renders
The full layout maintains accessibility with:
- Proper ARIA labels
- Keyboard navigation support
- Screen reader compatibility
- Focus management
Enjoy exploring the full capabilities of the MarkdownLayout system!