Skip to content

Latest commit

 

History

History
83 lines (56 loc) · 5.99 KB

table.md

File metadata and controls

83 lines (56 loc) · 5.99 KB
Raw
description
Keep information organized and make documenting data easier by adding a table to your page.

Tables

You can add tables to better organize your information in a GitBook page. As you would expect, you can add and remove columns, set the type of data in a column, choose text alignments, and much more.

{% hint style="info" %} You can make table blocks span the full width of your window by clicking on the Options menu next to the block and choosing Full width. {% endhint %}

CompanyStatusContactMRRContactMRRStatus
Ace AI – DesignIn progress[email protected]$450[email protected]$420In progress
Discrete Data – API[email protected]$100[email protected]$69

Table block options

When you open the Options menu to the left of a table block, you’ll have a number of options to change the apperance and manage the data inside the table:

  • Table/Cards: Choose to display your data as either a table block or a cards block. GitBook populates both these blocks using the same data, so you can switch between them depending on the look and design you want.
  • Add column: Add a new column to the right of your table. You can choose column type using the menu, or just click Add column to add a text column.
  • Insert row: Add a new row to the bottom of your table.
  • Show header: Hide or show the top totle row of your table. Depending on the data you’re display, you may not need a title row in your table, so you can disable it here.
  • Reset column sizing: If you’ve changed the column widths, this will reset them all to be equal again.
  • Visible columns: Choose which columns are visible and which are hidden. If you have hidden columns in your table, this menu is where you can make them visible again.
  • Full width: Make your table span the full width of your window. This is great for tables with lots of columns.
  • Delete: Deletes the table block and all of it’s content.

Changing a column type

Depending on the data you want to display, you can set table columns can have different data types. These add formatting, embellishments or restrictions to every cell in the column:

  • Text: A standard text column, with standard formatting support.
  • Number: A number column, with or without floating digits.
  • Checkbox: A checkbox on each line that can be checked or unchecked.
  • Select: You can select data from a list of options that you can define by opening the columns’s Options menu and choosing Manage options. This can be single-choice or multiple-choice.
  • Users: You can add the name and avatar of a member of your organization. This can be single-choice or multiple-choice.
  • Files: You can reference a file in the space. You can upload new files when populating cells in the column.
  • Rating: A star rating. You can configure the maximum rating by opening the column’s Options menu and choosing Max.

Use the column’s Option menu to change a column’s type. When you change a column type, you’ll see a prompt asking you to confirm the change, as column data could be deleted or broken by this action.

Resizing columns

Hover over a column’s edge and drag to resize it. GitBook stores column sizes as a percentage of the overall width, which allows for relative sizing based on the overall width of the table.

Scrolling tables

Tables that are wider than the editor container will be horizontally scrollable.

Column options

To reorder columns, click and drag on the Options button in the column you want to move.

Inside the Options menu you can also switch automatic sizing on and off, add a new column to the right, hide the column, or delete the column.

Row options

To open a row’s Options menu, hover over the row and click the Options button that appears on the left of it. You’ll see a number of options

  • Open row: Open the row in a modal that shows all of its data. Here you can quickly change row types, edit data, and see data in hidden columns.
  • Insert above/below: Add a new row above or below the currently-selected row.
  • Add column: Add a new column on the right of the table.
  • Delete row: Permanently remove all the data in the row from your table.

Images in tables

When you click into a table cell, you can hit the / key to insert images. Note that this will not work in the header row.

Representation in Markdown

# Table

|   |   |   |
| - | - | - |
|   |   |   |
|   |   |   |
|   |   |   |