skip to main content
Output Formats » Markdown++ Output Format » Markdown++ Tables and Layout
Markdown++ Tables and Layout
Markdown++ extends traditional Markdown with advanced table support and flexible layout options, enabling you to create professional, structured documents with ease. The multi-line pipe table feature, a standout capability of Markdown++, supports complex content within table cells, including multi-line text, images, and rich formatting. This section introduces the configuration options available for Markdown++ tables and provides insights on maximizing their layout potential. By mastering these features, you can adapt Markdown++ to meet diverse documentation needs, from data-rich tables to intricate, styled layouts, ensuring seamless output across Markdown-aware tools and ePublisher’s full range of output formats.
Introduction to Markdown++ Multi-line Pipe Tables
One of the most powerful features of the Markdown++ output format is its advanced support for tables, allowing technical authors to create professional, complex table layouts within Markdown. Markdown++ offers two table-rendering options under the Table Style setting, called Table Rendering:
  • Pipes Multiline (default): Supports multi-line cell content, along with embedded Markdown++ elements such as paragraphs, character styles, images, and markers.
  • Pipes: Traditional Markdown pipe tables, suitable for simpler tables or datasets.
Using Multi-line Pipe Tables
The Pipes Multiline option is recommended for most users because it offers complete support for multi-line content within cells. This setting preserves the readability and formatting of complex tables, allowing for robust styling and layout configurations that are compatible with Markdown syntax.
Key Advantages of Multi-line Pipe Tables:
  • Supports Advanced Content: Each cell can contain multi-line content, including nested Markdown++ paragraphs, images, and markers.
  • Compatibility with Markdown Tools: While fully compatible with most Markdown-aware tools, tools that do not support Markdown++ will render a basic version of the table without advanced styling. Multi-line content will appear as individual rows in non-Markdown++ viewers, preserving basic readability.
  • Migration Capabilities: Use multi-line pipe tables to transfer complex tables from FrameMaker, Word, or DITA-XML, retaining layout fidelity within Markdown while making content more accessible and transparent.
Configuring Table Rendering
To configure the table rendering mode:
  1. In ePublisher Designer, open the Style Designer for your project.
  2. Select the Table Style you wish to configure.
  3. Locate the Table Rendering option.
  4. Choose either:
    • Pipes Multiline: For full-featured tables that support multi-line and styled content.
    • Pipes: For simple, single-line tables with basic content.
  5. Save your settings to apply changes to the Markdown++ output.
Benefits of Markdown++ Tables Across ePublisher Outputs
Markdown++ tables can be styled with a Markdown++ style name, providing consistent and rich styling options when generating other ePublisher outputs such as PDF, WebWorks Reverb 2.0, or HTML. This allows authors to leverage Markdown++’s Markdown-based transparency while still achieving high-quality output across multiple formats.
For simpler tables focused on plain data representation, the Pipes option provides a straightforward solution, ideal for basic data tables or scenarios where simplicity is a priority.
Markdown++’s multi-line pipe tables offer an unparalleled combination of compatibility and fidelity, bridging the gap between traditional authoring tools and the flexibility of Markdown. This unique feature empowers authors to retain full control over table layouts, bringing Markdown-based tables to a professional standard without sacrificing compatibility.
Was this helpful?
Last modified date: 11/15/2024