mdpaste-0.8.0 is not a library.

mdpaste

A CLI tool that reads an image from the clipboard, saves it as a WebP file, and outputs a Markdown image link.

Features

Reads images and file drops from the clipboard
Saves images in WebP format
Supports three storage backends:
- Local: saves to a local directory (default: images/)
- R2: uploads to Cloudflare R2 and returns a public URL
- NodeBB: uploads to a NodeBB forum via the post upload API
Backend selection: CLI flag > project config > global config > local (fallback)
WSL2 and native Windows support via PowerShell

Installation

Homebrew (macOS / Linux)

brew tap daaa1k/tap
brew install mdpaste

Supports macOS (Apple Silicon) and Linux (x86_64). Intel Mac users can install via Cargo or Nix instead.

Windows

Download the pre-built binary from the latest GitHub Release:

mdpaste-windows-x86_64.exe

Place it somewhere on your PATH (e.g. C:\Users\<you>\bin\) and rename it to mdpaste.exe.

Alternatively, install via Cargo (requires Rust toolchain):

cargo install mdpaste

Nix / Home Manager (recommended)

Add to your Home Manager configuration:

inputs.mdpaste.url = "github:daaa1k/mdpaste";

# in your Home Manager module:
imports = [ inputs.mdpaste.homeManagerModules.default ];

programs.mdpaste = {
  enable = true;
  # Optional: use the pre-built binary from GitHub Releases (no Rust compilation)
  # package = inputs.mdpaste.packages.${pkgs.system}.mdpaste-bin;
  settings = {
    backend = "r2";
    r2.account_id = "your-account-id";
    # R2 credentials via R2_ACCESS_KEY_ID / R2_SECRET_ACCESS_KEY env vars
  };
};

programs.mdpaste.settings is written to $XDG_CONFIG_HOME/mdpaste/config.toml automatically.

Cargo

cargo install mdpaste

Or build from source:

cargo install --path .

Usage

mdpaste                    # use configured backend
mdpaste --backend r2       # force R2 backend
mdpaste --backend local    # force local backend
mdpaste --backend nodebb   # force NodeBB backend

Output example:

![](images/20240312_153045.webp)

Configuration

Project config (`.mdpaste.toml`)

Place this file in your project root (or any ancestor directory). Searched upward from the current directory.

backend = "r2"   # "local", "r2", or "nodebb" (optional, overrides global)

[local]
dir = "images"   # directory for local backend (default: "images")

[r2]
bucket     = "my-bucket"
public_url = "https://assets.example.com"
prefix     = "images/"   # optional key prefix

[nodebb]
url = "https://forum.example.com"

Global config

Platform	Default path
macOS / Linux	`~/.config/mdpaste/config.toml` (respects `XDG_CONFIG_HOME`)
Windows	`%APPDATA%\mdpaste\config.toml`

backend = "local"   # default backend

[r2]
account_id = "..."
endpoint   = "https://..."   # optional, defaults to https://<account_id>.r2.cloudflarestorage.com

[wsl]
# WSL2 only: specify absolute path when PowerShell is not in PATH
# (e.g., when appendWindowsPath = false in /etc/wsl.conf)
powershell_path = "/mnt/c/Program Files/PowerShell/7/pwsh.exe"

R2 credentials

R2 access credentials are read from environment variables:

export R2_ACCESS_KEY_ID="your-access-key"
export R2_SECRET_ACCESS_KEY="your-secret-key"

NodeBB credentials

NodeBB login credentials are read from environment variables:

export NODEBB_USERNAME="your-username"
export NODEBB_PASSWORD="your-password"

WSL2 Notes

On WSL2, mdpaste uses PowerShell to access the Windows clipboard. If PowerShell is not in PATH (e.g., appendWindowsPath = false in /etc/wsl.conf), specify its absolute path in the [wsl] section of the global config.

PowerShell resolution order:

powershell_path from [wsl] config
powershell.exe / pwsh.exe in PATH
Well-known paths under /mnt/c/

Windows Notes

On native Windows, mdpaste uses PowerShell (System.Windows.Forms) to access the clipboard. Both Windows PowerShell (powershell.exe) and PowerShell Core (pwsh.exe) are supported.