← Overview

Tables in GitHub-Flavored Markdown (GFM) — the same syntax Obsidian renders in reading view.

How you write it in Obsidian

| Name  | Value |
|:------|------:|
| Alpha | 1     |
| Beta  | 2     |

• The first row is the column headers.
• The second row is the separator — it is required; it is what makes the block a table.
• The colons in the separator set the alignment per column: :--- left, :--: centered, ---: right.
• The usual inline formatting works inside cells (bold, italic, inline code).

What Obsitex generates

A tabular environment. The exact look is driven by your Document Design Settings (DDS) — whether horizontal rules (\hline) and vertical rules (|) are drawn, the default alignment, and the surrounding environment.

\begin{table}[h]
 \centering
 \begin{tabular}{|l|r|}
 \hline
Name & Value \\
\hline
Alpha & 1 \\
\hline
Beta & 2 \\
\hline
 \end{tabular}
\end{table}

How it looks in the PDF

<aside> 📸

Screenshot needed: the compiled PDF of the table above — a two-column grid, the "Value" column right-aligned.

</aside>

Tips & pitfalls

• The number of columns follows the header row; missing cells are padded empty.
• For very wide tables, adjust the DDS table environment to tabularx or longtable.
• Grid lines, default alignment and the whole environment are set once in Settings → DDS, not per table.