Skip to main content
Version: 1.3.x

Tables

Description​

Tables are a key feature in Markdown for organizing and presenting data clearly and effectively. ParsedownExtended supports the standard Markdown syntax for creating tables, which involves using hyphens (---) for defining columns and pipes (|) for separating them. For enhanced readability and compatibility, it's recommended to include pipes at the beginning and end of each row as well.

Configuration Syntax​

Configure table rendering in ParsedownExtended using the config()->set() method:

$ParsedownExtended->config()->set('tables', (bool|array) $value);

This setting can be a boolean to enable or disable table rendering globally, or an array for more specific configurations.

Parameters​

  • tablespan (boolean): Enables or disables the use of table spans (colspan and rowspan) in tables. This feature is disabled by default.

Examples​

Enable Table Rendering​

To enable the rendering of tables with default settings:

$ParsedownExtended->config()->set('tables', true);

Enable Tablespan​

To enable table spans, allowing for more complex table layouts:

$ParsedownExtended->config()->set('tables', [
    'tablespan' => true
]);

Disable Tables​

To completely disable table rendering:

$ParsedownExtended->config()->set('tables', false);

Markdown Table Example​

Create a table in Markdown:

| Header 1 | Header 2 | Header 3 |
| -------- | -------- | -------- |
| Row 1    | Data     | Data     |
| Row 2    | Data     | Data     |

This documentation ensures that users have clear and precise instructions on how to configure and use the table rendering features within ParsedownExtended, using the correct syntax and context.