Press / to focus
Codeberg Documentation

Getting Started with Codeberg
What is Codeberg? Your First Steps on Codeberg Install Git Your First Repository The Basics of Issue Tracking Integrated Wiki Email Settings Licensing on Codeberg Frequently Asked Questions
Collaborating with Others
Citable Code Pull requests and Git flow Invite Collaborators Create and Manage an Organization Repository Permissions Resolve Conflicts
Working with Git Repositories
Using .gitignore Configuring Git Clone & Commit via CLI Clone & Commit via Web Merge multiple commits into one Tags and Releases Working with large files
Writing in Markdown
Introduction to Markdown Using Links Topics Preformatted Text Using Images Using Lists Tables in Markdown Markdown FAQ
Security
Setting up two-factor authentication Adding an SSH key to your account Verifying you're connected to Codeberg using SSH fingerprints Adding a GPG key to your account
Codeberg Pages
Using Custom Domains Troubleshooting Example: Docs as Code with Sphinx Pushing output from SSGs into Codeberg Pages Redirects
Advanced Usage
Using Webhooks Generating an Access Token Migrating Repositories
Working with Codeberg's CI
Using Forgejo Actions (Self-hosted)
Integrations with Other Services
Integrating with Keycloak Integrating with Matrix Integrating with Read the Docs
Codeberg Translate
Getting started Manual Component configuration Introduction to Weblate
Improving Codeberg
Contributing Code
Improving the Documentation
Style Guide How to create a new article? Can I preview my article? How to make screenshots for Codeberg Documentation? Documentation Contributor FAQ
Contact

Tables in Markdown

Markdown files can contain tables to structure data.

Table syntax

Markdown tables are written ("drawn") using the characters pipe |, dash - and colon :.

A simple table looks like this:

| This   | is    | a       |
| ---    | ---   | ---     |
| simple | table | example |
This is a
simple table example

The table columns do not have to align in the un-rendered text, but it improves readability to keep everything aligned in the un-rendered form as well.

Some editors automatically align the table structure.

The first line of a table forms the head of the table. It is separated from the rest of the data by a line of dashes.

| Name   | Comment                                                                 |
|:-------|:------------------------------------------------------------------------|
| Alice  | Always involved in various communications                               |
| Bob    | A good guy, who likes to communicate with Alice                         |
| Malroy | Not so nice guy. Tries to mess with the communication of Alice and Bob. |
Name Comment
Alice Always involved in various communications
Bob A good guy, who likes to communicate with Alice
Malroy Not so nice guy. Tries to mess with the communication of Alice and Bob.

The line following the head may contain formatting help to the renderer.

The location of the colon : (if any) modifies how the table is rendered.

If the colon is to the left of the line of dashes separating data from the header, then the data is rendered left-aligned.

For example

| Left oriented rendering |
|:------------------------|
| 150.0                   |
| or text                 |

renders as

Left oriented rendering
150.0
or text

Whereas:

| Right oriented rendering |
|-------------------------:|
| 150.0                    |
| or text                  |

is rendered as

Right oriented rendering
150.0
or text

If the rendering hint is placed on both sides of the dashed line, the data is rendered as centered:

| Centered rendering |
|:------------------:|
| 150.0              |
| or text            |

Is rendered as:

Centered rendering
150.0
or text

Providing no rendering hint leaves it up to the renderer to decide how to render the data. Left-aligned is a common default.

| Un-hinted rendering |
|---------------------|
| 150.0               |
| or text             |

Is rendered as:

Un-hinted rendering
150.0
or text

Table variations

Some renderers allow you to omit the delimiting pipe symbols | at the side of the table:

This   | is    | a      
---    | ---   | ---    
simple | table | example

is rendered as

This is a
simple table example

This is even considered an error by some editors.

However, for readability reasons we propose to use the delimited form within Codeberg.

Hey there! 👋 Thank you for reading this article!

Is there something missing, or do you have an idea on how to improve the documentation? Do you want to write your own article?

You're invited to contribute to the Codeberg Documentation at its source code repository, for example, by adding a pull request or joining in on the discussion in the issue tracker.

For an introduction on contributing to Codeberg Documentation, please have a look at the Contributor FAQ.

© Codeberg Docs Contributors. See LICENSE