Skip to content
Conduit

skill

telegraph-cli

Markdown → telegra.ph publisher. Stdlib-only Python 3 CLI: publish, --edit existing pages, tables, images, h3/h4 normalization.

dim-s/telegraph-clicommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/dim-s/telegraph-cli itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 21, 2026

telegraph-cli

Markdown → telegra.ph publisher. Single-file Python 3 CLI, stdlib only, no runtime dependencies, no build step.

Publishes a Markdown file as a telegra.ph article, edits existing pages, uploads images, and prints the resulting URL.

Install

Works on macOS, Linux, and Windows. Requires Python 3.8+.

pip install git+https://github.com/dim-s/telegraph-cli.git

That's it. pip creates a telegraph-publish executable on your PATH (including a proper .exe shim on Windows). No git clone, no symlinks, no shell-specific setup.

To upgrade:

pip install -U git+https://github.com/dim-s/telegraph-cli.git

Alternatives

With pipx (isolated, recommended if you don't want to pollute your base Python):

pipx install git+https://github.com/dim-s/telegraph-cli.git

With uv tool (fastest):

uv tool install git+https://github.com/dim-s/telegraph-cli.git

Manual (just the script, no install):

curl -fsSL https://raw.githubusercontent.com/dim-s/telegraph-cli/main/telegraph_publish.py \
  -o ~/.local/bin/telegraph-publish
chmod +x ~/.local/bin/telegraph-publish

Quick start

# publish a markdown file → prints the page URL
telegraph-publish draft.md

# parse only, print stats, do not call the API
telegraph-publish draft.md --dry-run

# update an existing page (URL or path)
telegraph-publish draft.md --edit https://telegra.ph/My-Post-05-27

# upload a single image, print its URL
telegraph-publish --upload-image cover.png

# publish without auto-uploading local images
telegraph-publish draft.md --no-image-upload

# publish with a specific author name (and optional link)
telegraph-publish draft.md --author "Jane Doe" --author-url https://example.com

On first publish the script creates a telegra.ph account and caches the access token in ~/.config/telegraph/account.json (or %APPDATA%\telegraph\account.json on Windows — Python's Path.home() locates it for you). Keep that file — without it the pages you created become unmanageable (telegra.ph has no "recover account" flow).

Markdown support

MarkdownRenders as
# Title (first one)Page title
##, ###<h3> (telegra.ph has no <h2>)
####<h4>
--- on its own line<hr>
**bold**<strong>
*italic*<em>
`code`<code>
[text](url)<a href>
![alt](path) block<figure><img><figcaption> (local paths auto-upload)
Pipe tableOne paragraph per data row, headers in <strong>, cells joined by ·

Tables are not natively supported by telegra.ph — the script renders each row as a compact bold-header paragraph. If you need real tables, telegra.ph is the wrong platform.

Author

By default published pages have no author line. Provide one via CLI or env when you want it:

SourcePurpose
--author NAMEAuthor name shown under the article title (per call)
--author-url URLLink wrapped around the author name (per call)
TELEGRAPH_AUTHOR envFallback when --author is omitted
TELEGRAPH_AUTHOR_URL envFallback when --author-url is omitted
TELEGRAPH_SHORT_NAME envShort account name on first run (default: Anonymous)

CLI flags override env. Empty author is valid — telegra.ph simply renders the page without an author block.

TELEGRAPH_SHORT_NAME is only used the very first time the script runs (when it creates the telegra.ph account); after that it's ignored.

Known limits of telegra.ph (not bugs of this CLI)

  • No <h1> or <h2> — headings of any level collapse to h3/h4.
  • No <table> — tables are rendered as paragraph-per-row.
  • --upload-image often returns Unknown error (HTTP 400) — telegra.ph has throttled its public /upload endpoint for external clients since ~2022. Host images on any CDN and pass absolute URLs in markdown when this happens. The script reports a clear error, not a traceback.
  • --edit only works for pages created with the same access token. Delete ~/.config/telegraph/account.json and your previous pages become read-only.

Claude Code skill

For Claude Code users: the skill/ directory contains a ready-to-use skill (SKILL.md + setup.md) so the agent can invoke telegraph-publish on demand and self-install when the CLI is missing.

Install — pick the line that matches your OS. No git clone, no symlinks needed (unless you want them).

macOS / Linux:

mkdir -p ~/.claude/skills/telegraph && \
curl -fsSL -o ~/.claude/skills/telegraph/SKILL.md https://raw.githubusercontent.com/dim-s/telegraph-cli/main/skill/SKILL.md && \
curl -fsSL -o ~/.claude/skills/telegraph/setup.md  https://raw.githubusercontent.com/dim-s/telegraph-cli/main/skill/setup.md

Windows (PowerShell):

$dir = "$env:USERPROFILE\.claude\skills\telegraph"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
Invoke-WebRequest https://raw.githubusercontent.com/dim-s/telegraph-cli/main/skill/SKILL.md -OutFile "$dir\SKILL.md"
Invoke-WebRequest https://raw.githubusercontent.com/dim-s/telegraph-cli/main/skill/setup.md  -OutFile "$dir\setup.md"

Already cloned the repo? Symlink instead — edits to the skill stay in sync with git pull:

ln -s "$(pwd)/skill" ~/.claude/skills/telegraph

After install, restart Claude Code (or /reload) so the new skill is indexed. The CLI itself installs automatically the first time the skill fires — setup.md guides the agent through it.

License

MIT © 2026 Дмитрий Зайцев (Dmitry Zaytsev)

↑↓ navigate openesc close