From markdown
Guides creation and formatting of Markdown tables with syntax, alignment, pipe escaping, inline markdown, multi-line workarounds, empty cells, and wide table strategies.
How this skill is triggered — by the user, by Claude, or both
Slash command
/markdown:markdown-tablesThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Comprehensive guide to creating and formatting tables in markdown.
Comprehensive guide to creating and formatting tables in markdown.
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
Renders as:
| Header 1 | Header 2 | Header 3 |
|---|---|---|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
| Left | Center | Right |
|:---------|:--------:|---------:|
| Left | Center | Right |
| aligned | aligned | aligned |
Renders as:
| Left | Center | Right |
|---|---|---|
| Left | Center | aligned |
| text | text | text |
:--- Left align (default):--: Center align---: Right alignThe pipes and dashes don't need to align:
|Header|Header|
|-|-|
|Cell|Cell|
However, aligned tables are more readable in source.
Use \| to include a literal pipe in a cell:
| Command | Description |
|---------|-------------|
| `a \| b` | Pipe operator |
| `cmd \|\| exit` | Or operator |
Tables support inline markdown:
| Feature | Syntax |
|---------|--------|
| **Bold** | `**text**` |
| *Italic* | `*text*` |
| `Code` | `` `code` `` |
| [Link](url) | `[text](url)` |
Standard markdown tables don't support multi-line cells. Workarounds:
<br> Tags| Step | Description |
|------|-------------|
| 1 | First line<br>Second line |
| 2 | Another step |
For complex layouts, use HTML:
<table>
<tr>
<th>Header</th>
<th>Description</th>
</tr>
<tr>
<td>Item</td>
<td>
<ul>
<li>Point one</li>
<li>Point two</li>
</ul>
</td>
</tr>
</table>
Use a space or leave empty:
| A | B | C |
|---|---|---|
| 1 | | 3 |
| 4 | 5 | |
For tables with many columns, consider:
<div style="overflow-x: auto;">
| Col 1 | Col 2 | Col 3 | Col 4 | Col 5 | Col 6 |
|-------|-------|-------|-------|-------|-------|
| Data | Data | Data | Data | Data | Data |
</div>
Transform wide tables into key-value pairs:
### Item 1
| Property | Value |
|----------|-------|
| Name | Foo |
| Type | Bar |
| Status | Active |
| Feature | Free | Pro | Enterprise |
|---------|:----:|:---:|:----------:|
| Users | 5 | 50 | Unlimited |
| Storage | 1GB | 10GB| 100GB |
| Support | ❌ | ✅ | ✅ |
| Parameter | Type | Required | Description |
|-----------|------|:--------:|-------------|
| `id` | string | ✅ | Unique identifier |
| `name` | string | ✅ | Display name |
| `limit` | number | ❌ | Max results (default: 10) |
| Action | Windows/Linux | macOS |
|--------|---------------|-------|
| Copy | `Ctrl+C` | `⌘+C` |
| Paste | `Ctrl+V` | `⌘+V` |
| Undo | `Ctrl+Z` | `⌘+Z` |
| Version | Date | Changes |
|---------|------|---------|
| 2.0.0 | 2024-01-15 | Breaking: New API |
| 1.2.0 | 2024-01-01 | Added feature X |
| 1.1.0 | 2023-12-15 | Bug fixes |
\| for literal pipes| Rule | Description |
|---|---|
| MD055 | Table pipe style should be consistent |
| MD056 | Table column count should match header |
| MD058 | Tables should be surrounded by blank lines |
Term 1
: Definition 1
Term 2
: Definition 2
- **Name**: John Doe
- **Email**: [email protected]
- **Role**: Developer
- Item 1
- Property A: Value
- Property B: Value
- Item 2
- Property A: Value
- Property B: Value
npx claudepluginhub thebushidocollective/han --plugin markdownProvides reference for core Markdown syntax: headings, text formatting, lists, links, images, code blocks, blockquotes. Use when writing or editing Markdown files.
Creates and edits Obsidian Flavored Markdown including wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Activates when working with .md files or when the user mentions wikilinks, callouts, frontmatter, tags, or embeds.
Generates and manages table of contents for markdown files in Claude Code. Useful for navigating long documents.