Is it possible to center tables in a markdown file?

Question

I have a table:

    | This | Is | A | Table |
    | :--- | -- | - | ----: |
    | foo  | ba | r | elbaT |

I'd like the table to display in the center of my Markdown file instead of left-aligned. I am not trying to align text, but the entire table itself. Do I need to resort to HTML/CSS to achieve what I want?

This is for an Apiary.io project.

Solution 1

My solution detailed by Gaffney in an Apiary.io issue comment.

Basically I add custom stylesheets and scripts within apiary.apib HTML blocks to style the page with HTML instead of headwalling that a Markdown dialect isn't CSS.

Also "How to Center Anything in CSS".

Solution 2

If you use the standard documentation, use the <center> tag like so.

Blueprint

FORMAT: 1A
HOST: http://www.google.com

# Tables
Notes API is a *short texts saving* service similar to its physical paper presence on your table.

<center>

| Tables   |      Are      |  Cool |
|----------|:-------------:|------:|
| col 1 is |  left-aligned | $1600 |
| col 2 is |    centered   |   $12 |
| col 3 is | right-aligned |    $1 |

</center>

# Group Notes

(...)

Preview

---

If you use the ‘New Documentation’, it's not possible to center a table (since the table takes a full width of the column).

Preview

Solution 3

It is simple. As you know the "|-|" is used for indicate the table and ":" is used for indicate the text alignment. If |:-| entered that is a right aligned text column. If |-:| entered that is a left aligned text and if |:-:| entered that is a centre aligned.

Solution 4

Yes. You can have GFM tables in API Blueprint – check http://docs.tables.apiary.io for rendered version of the blueprint source bellow.

FORMAT: 1A

# Tables API 
Note: Tables can be handcrafted or generated at <http://www.tablesgenerator.com/markdown_tables>.

## Table 1
**Discussion option 1**

| Tables   |      Are      |  Cool |
|----------|:-------------:|------:|
| col 1 is |  left-aligned | $1600 |
| col 2 is |    centered   |   $12 |
| col 3 is | right-aligned |    $1 |

# Message [/pages]
## Create a Message [POST]

### Table 2
**Discussion option 2**

| Tables   |      Are      |  Cool |
|----------|:-------------:|------:|
| col 1 is |  left-aligned | $1600 |
| col 2 is |    centered   |   $12 |
| col 3 is | right-aligned |    $1 |

+ Request (application/json)

    ## Table 3
    **Discussion option 3**

    | Tables   |      Are      |  Cool |
    |----------|:-------------:|------:|
    | col 1 is |  left-aligned | $1600 |
    | col 2 is |    centered   |   $12 |
    | col 3 is | right-aligned |    $1 |

    + Headers

            Authorization:Bearer tokenString

    + Body

            { ... }

+ Response 201

Solution 5

A simple method that everyone seems to have overlooked is to enclose the table within a div and use the align="center" property on it.

<div align="center">

| Tables   |      Are      |  Cool |
|----------|:-------------:|------:|
| col 1 is |  left-aligned | $1600 |
| col 2 is |    centered   |   $12 |
| col 3 is | right-aligned |    $1 |

</div>

Works just like <center> used to. No need to worry about <center> getting deprecated anymore. ;)

View more solutions

Comments

[phoenix]

For Material for MkDocs: github.com/squidfunk/mkdocs-material/issues/…

[jackr]

Isn't the question about "centering the whole table on the page"? Whereas this response is about "centering the text within a single column"? I can't find anywhere that any Markdown variant allows centering or indenting text (except pre/code blocks, but they also literalize the Markdown that defines the table).

[Zdenek]

Good point! I have misunderstood the answer – AFAIK there is no way to do it within Apiary. I will keep you updated on whether/how it is possible in the embedded documentation.

[Meredith]

While this at least directly answers my question, the second hit on Google (for me) leads to a StackOverflow question asking why center is deprecated. Thanks for the effort though

[AIDoubt]

As is sometimes the case, the actual answer is at the bottom

[Bryan K]

The question, however, is for centering the table itself, and not its contents. I can see how it's easy to misunderstand though.

[Rohan Lekhwani]

@Gangula sure that would center align text within the table but to center align the table itself within the markdown file (which is what the op actually wants) you'd need a <div align="center">

[Gangula]

Oh, my bad. I misunderstood the question.