README file from
GithubTable Beautifier
An Obsidian plugin that converts ASCII and Unicode box-drawing tables into Markdown tables.
Useful when pasting terminal output from CLI tools like Claude Code, Docker, psql, MySQL, and others that render tables with box-drawing characters.
Before
┌──────────────────┬───────────────────────┐
│ Code │ Description │
├──────────────────┼───────────────────────┤
│ MyClass │ This is my class │
├──────────────────┼───────────────────────┤
│ YourClass │ This is your class │
└──────────────────┴───────────────────────┘
After
| Code | Description |
|---|---|
MyClass |
This is my class |
YourClass |
This is your class |
Usage
- Select the table text in the editor
- Right-click and choose Convert table to Markdown, or
- Open the command palette (
Cmd+P) and run Table Beautifier: Convert table to Markdown
The context menu item only appears when the selection contains table-like characters.
Supported Formats
- Unicode box-drawing tables (
┌ ─ ┬ ┐ │ ├ ┼ ┤ └ ┴ ┘) - ASCII tables (
+ - | =)
Features
- Columns are padded for visual alignment
- Values that look like code identifiers (
PascalCase,snake_case,dot.notation) are wrapped in backticks
Development
npm install
npm run build
npm test
To develop with live reload, run npm run dev and symlink the plugin directory into your vault:
ln -s /path/to/obsidian-table-beautifier /path/to/vault/.obsidian/plugins/table-beautifier
Installation
Copy main.js and manifest.json into your vault's .obsidian/plugins/table-beautifier/ directory, then enable the plugin in Settings.
Releasing
-
Bump
versioninmanifest.jsonandpackage.json(semver, e.g.1.0.1). -
Commit the bump:
git commit -am "chore: release 1.0.1" -
Build and tag. The tag must match
manifest.jsonversionexactly — novprefix:npm run build git tag 1.0.1 git push origin main 1.0.1 -
Create a GitHub release at the tag and attach
main.jsandmanifest.jsonas individual asset files (not zipped).