On this page
Overview
The CSV macro can import, format and display comma-separated values (CSV) data from anywhere, by:
- Reading the CSV data from any of these sources:
- Within your Confluence page.
- From a file residing on the Confluence server (Server only).
- From a global or space template (Server only).
- From a page attachment.
- From an external URL.
- Allowing customizable delimiters, quote characters, and character encoding.
- Supporting inclusion of Wiki Markup macros within the CSV data.
- Combining with the Chart macro to produce powerful data visualization.
- Leveraging the same table styling capabilities as the Table Plus macro.
CSV is not a formal standard, but the best reference is The Comma Separated Value (CSV) File Format. The support in this macro comes close to following this pseudo-standard. This macro supports Common table capabilities.
Feature Video
Basic Use
This macro can be deployed using one of the following methods:
Selected from the Macro Browser | CSV (Comma Separated Values) |
---|---|
Markup Shortcut | {csv} |
Screenshot
Parameters
Click a column heading to toggle the sorting of that column.
Augment parameters
See Augments for details.
Common parameters
Click a column heading to toggle the sorting of that column.
Examples
Compatibility
- Chart Macro - the CSV Macro can be used to create data for a chart
- Beanshell Macro - can be used to generate csv macro and data as output from Java code (use output=wiki)
- Groovy Macro - can be used to generate csv macro and data as output from Groovy code (use output=wiki)
- Jython Macro - can be used to generate csv macro and data as output from Jython code (use output=wiki)
Other Macros
Below is a list of all other Macros available within this Add-on:
-
Attachment Table Macro (Advanced Tables for Confluence)
-
CSV Macro (Advanced Tables for Confluence)
-
JSON Table Macro (Advanced Tables for Confluence)
-
Table Plus Macro (Advanced Tables for Confluence)
Additional References
- Augments
- The Comma Separated Value (CSV) File Format
- Common table capabilities
- Scripting for Confluence
- Run CLI Actions in Confluence
- SQL for Confluence
- Beanshell Macro
- Groovy Macro
- Jython Macro
- How to deal with templates on Confluence 4.3 and later