Multiline Tables in Markdown++

Authoring Source Documents » Markdown++ Source Documents » Learning Markdown++ » Multiline Tables in Markdown++

Multiline tables in Markdown++ provide an enhanced way to organize detailed content across multiple lines, allowing for more readable and flexible structures. Unlike standard tables, multiline tables allow rows to span multiple lines by using a special tag and structured spacing.

Introduction

Multiline tables are very similar to regular Markdown tables, but they are more flexible when it comes to the table structure. In Markdown++, multiline tables are indicated by placing a  tag directly above the table. Additionally, a new row is created by adding a row of cells that are either empty or contain only whitespace.

A key feature of multiline tables is that you can include full block Markdown elements within cells, such as lists, code blocks, or paragraphs. This makes multiline tables particularly useful when content within a cell becomes too detailed to fit conveniently on a single line. By utilizing multiline tables, writers can keep content organized and easier to edit.

Syntax

Multiline tables in Markdown++ consist of the same main elements as standard tables:

A header row, which contains header cell content separated by | characters.
An alignment row, which indicates the alignment of the body cells' text. Each cell in this row contains at least 3 - characters, and an optional : character to indicate alignment. Each cell is separated by a | character.
- Default alignment only uses - characters; 3 or more.
- Left align the column by starting the cell with : and filling in the rest with : characters; 3 or more.
- Right align the column by starting the cell with 3 or more - characters, ending with a : character.
- Center align the column by starting and ending the cell with : characters. Put - characters between them; 3 or more.
1 or more body rows, that contain body cell content separated by | characters.

The key difference is the  tag and the ability to use blank rows to create new table rows, along with the capability to write full block Markdown inside cells.

Multiline Tag

To use a multiline table, add the following tag directly above your table:

<!-- multiline -->

This tag tells Markdown++ to treat the following table as a multiline table.

Creating New Rows

To create a new row, simply add a row of cells that are either empty or contain only whitespace. This indicates to Markdown++ that the next line of cells should be treated as part of a new row.

Basics

Below is an example of a multiline table:

<!-- multiline -->
| name | details                   |
|------|--------------------------|
| Bob  | Lives in Dallas.         |
|      | - Enjoys cycling         |
|      | - Loves cooking          |
|      |                          |
| Mary | Lives in El Paso.        |
|      | - Works as a teacher     |
|      | - Likes painting         |

In this example, the empty row acts as a separator, creating a break before the next row. Notice how detailed information, including lists, is included within a cell.

You can also use multiline tables without wrapping | characters:

<!-- multiline -->
 name | details
------|--------------------------
 Bob  | Lives in Dallas.
      | - Enjoys cycling
      | - Loves cooking
      |
 Mary | Lives in El Paso.
      | - Works as a teacher
      | - Likes painting

Alignment in Multiline Tables

Just like with standard tables, multiline tables can have different alignments for each column.

Left-align the text of cells in a column by starting the alignment cell with ::

<!-- multiline -->
| name | details                  |
|:-----|-------------------------|
| Bob  | Lives in Dallas.        |
|      | - Enjoys cycling        |
|      | - Loves cooking         |
|      |                         |
| Mary | Lives in El Paso.       |
|      | - Works as a teacher    |
|      | - Likes painting        |

Center-align the text of cells in a column by starting and ending the alignment cell with ::

<!-- multiline -->
|  name  | details                 |
|:------:|-------------------------|
|  Bob   | Lives in Dallas.        |
|        | - Enjoys cycling        |
|        | - Loves cooking         |
|        |                         |
|  Mary  | Lives in El Paso.       |
|        | - Works as a teacher    |
|        | - Likes painting        |

Markdown In Multiline Tables

Multiline tables can also include full Markdown blocks, such as code blocks or lists:

<!-- multiline -->
| name     | hobbies                 |
|----------|-------------------------|
| **Bob**  | - Biking                |
|          | - Cooking               |
|          | - Reading               |
|          |                         |
| **Mary** | Here is a code example: |
|          |                         |
|          | ```                     |
|          | function greet() {      |
|          |     console.log("Hi");  |
|          | }                       |
|          | ```                     |

Including full Markdown blocks like code and lists helps emphasize complex content within cells, making tables more versatile.

Markdown++ Custom Styles

A custom Table Style can be given to a multiline Table using a Markdown++ style tag directly above the multiline tag. Additionally, multiple Markdown++ commands can be combined using ;:

<!--style:CustomTable; multiline -->
| name | description                  |
|------|-----------------------------|
| Bob  | - Loves biking              |
|      | - Enjoys programming        |
|      |                             |
| Mary | A passionate teacher.       |
|      | - Loves painting            |
|      | - Enjoys hiking             |

Content in Cells

Inline text content can be further customized using the inline tag convention, and multiple commands can be used in a single tag:

<!-- multiline -->
| name                          | age | city    |
|-------------------------------|-----|---------|
| <!--style:CustomText-->*Bob*  | 42  | Dallas  |
|                               |     |         |
| <!--style:CustomText-->*Mary* | 37  | El Paso |

To learn more about Markdown++ tagging, see Learning Markdown++.

ePublisher Style Information

Style Behavior

In order to style a multiline Table and its cells in detail, the same styles are needed as with standard tables in ePublisher. A multiline table gets 3 styles when detected in a document: Table, Table Cell Head, and Table Cell Body.

Table Style

The Table Style is the primary style that ePublisher adds when a multiline table is detected. The default name is Table, but this can be customized using a Markdown++ style tag.

Customizing the Table Style

By adding a Markdown++ custom style tag, the Table Style name can be changed:

<!--style:CustomTable; multiline -->
| name | age | city    |
|------|-----|---------|
| Bob  | 42  | Dallas  |
|      |     |         |
| Mary | 37  | El Paso |

Header & Body Cell Styles

Header and body cell styles function in the same way for multiline tables as they do for standard tables. Each header cell gets a Table Cell Head style, and each body cell gets a Table Cell Body style. These styles can also be customized if the Table Style is given a custom name:

<!--style:CustomTable; multiline -->
| name | age | city    |
|------|-----|---------|
| Bob  | 42  | Dallas  |
|      |     |         |
| Mary | 37  | El Paso |

Default Style Properties

Style Type: Table, Paragraph
Style Name: Table, Table Cell Head, Table Cell Body

Table

Property	Value
border top color	#222222
border top style	solid
border top width	1px
border right color	#222222
border right style	solid
border right width	1px
border bottom color	#222222
border bottom style	solid
border bottom width	1px
border left color	#222222
border left style	solid
border left width	1px

Table Cell Head

Property	Value
font family	Arial
font size	11pt
font weight	bold
padding top	6pt
padding right	6pt
padding bottom	6pt
padding left	6pt

Table Cell Body

Property	Value
font family	Arial
font size	11pt
padding top	6pt
padding right	6pt
padding bottom	6pt
padding left	6pt

If a custom style name is assigned to a multiline Table, the style names will still inherit all of the listed default style information.

Was this helpful?

Last modified date: 11/15/2024