Skip to content
mdedit-cli

Write and manage Markdown from the CLI

The official CLI for MD Editor. Manage workspaces, folders, articles, and API keys without leaving your terminal.

terminal
# Install
npm install -g mdedit-cli

Terminal-native Markdown writing workflows

Write in the app, script from the terminal, and export wherever you publish.

Edit articles from anywhere

Create, inspect, and update content without context switching. Upload markdown from a file or stdin, then keep editing in the web app when you want.

Export and integrate

Pull markdown for pipelines, export ZIPs for sharing, and wire MD Editor into your docs workflow.

Automation-friendly when you need it

Readable output for humans, and a clean JSON mode for scripts and agent workflows when you want to pipe results elsewhere.

Prefer scripting? Use --format json.

Get started

Authenticate once, set a default workspace, and you’re ready to go. Get an API key.

terminal
# Authenticate
mdedit config login --api-key <KEY>
# Choose a workspace
mdedit workspace list
mdedit config use-workspace <workspaceId>
# Sanity check
mdedit info

Article workflows

Copy/paste friendly examples for the most common workflows. See the full CLI docs for every flag and option.

Read & export articles

List, inspect metadata, or pull markdown for piping.

terminal
# List articles (compact table)
mdedit article list
# Get article metadata
mdedit article get <articleId>
# Print markdown only (stdout)
mdedit article get <articleId> --content-only
# Export as a ZIP file
mdedit article export <articleId> --output ./article.zip

Edit articles

Create and update content from your terminal.

terminal
# Create an article (interactive)
mdedit article create
# Update title / archive / pin
mdedit article update <articleId> --title "New title"
mdedit article update <articleId> --archive
mdedit article update <articleId> --pin
# Update content from a file (or use - for stdin)
mdedit article update <articleId> --file ./article.md

Full CLI reference in the docs

Every command, flag, and configuration option is documented in the MD Editor docs.

Open CLI docs
Ready to write

Ready to write with confidence?

Join developers, writers, and creators who trust MD Editor for their best work.

Join 7,300+ users already using MD Editor.