mdcopy

mdcopy

Small macOS helper: feed it markdown, get rich text on the clipboard (headings, lists, tables, links) so you can paste into Mail, Slack, Google Docs, Word, and similar apps without reformatting by hand.

Typical flow: an LLM outputs markdown → you save or pipe it through mdcopy → paste into an email or doc and it looks like a normal formatted message, not fenced code or raw **bold** syntax.

For LLMs and “skills” (fetchable spec)

Point a skill or tool at the raw LLM.txt in this repo so the model always gets install paths, input modes, and limitations in one file (no prose drift).

• On GitHub (replace branch if needed): https://raw.githubusercontent.com/The-Focus-AI/mdcopy/main/LLM.txt
• Local copy: LLM.txt

Claude Code plugin (focus-marketplace)

This repository is also a Claude Code plugin (see .claude-plugin/plugin.json and skills/mdcopy/SKILL.md). After you add the Focus marketplace, install it with:

/plugin install mdcopy@focus-marketplace

That exposes the mdcopy skill and bundles bin/mdcopy under ${CLAUDE_PLUGIN_ROOT}. Registry entry: The-Focus-AI/claude-marketplace → plugin mdcopy → source repo The-Focus-AI/mdcopy.

Requirements

• macOS (uses swift + AppKit for the pasteboard)
• Pandoc: brew install pandoc

Install

Copy or link the script somewhere on your PATH, for example:

chmod +x bin/mdcopy
ln -sf "$(pwd)/bin/mdcopy" ~/bin/mdcopy   # if ~/bin is on your PATH

Usage

Input	Command
A file	./bin/mdcopy path/to/file.md
Stdin (e.g. LLM output)	cat draft.md | ./bin/mdcopy or pbpaste | ./bin/mdcopy
Clipboard as markdown	./bin/mdcopy (no args, no stdin: reads current clipboard text)

After it runs, use Paste in your target app. You should see “Rich text copied to clipboard” in the terminal.

Mail.app paste examples

Each code block is sample markdown you can copy into a file or pipe to ./bin/mdcopy. The image below it is Apple Mail after a rich paste from that same source.

Screenshots use HTML <img> with repo-relative src so they show inline in GitHub and in editor previews.

Headings and emphasis

# Weekly update

**Shipped** the new onboarding flow. *Next week*: polish analytics.

Bullet list

## Action items

- Reply to design with timeline
- Book 30m with legal
- Send the draft **before Friday**

Table

## Q1 snapshot

| Region | Status   |
| ------ | -------- |
| US     | On track |
| EU     | At risk  |

Blockquote

## Client note

> “We love the direction—let’s lock copy by **Tuesday** so we can ship.”

— PM, Acme Corp

Numbered list

## How to try the beta

1. Open the invite link
2. Sign in with your work email
3. Click **Start** on the home screen

Link and inline code

## Docs

See the guide at [docs.example.com](https://docs.example.com).

Run `pnpm install` then `pnpm dev` locally.

Examples in this repo

See examples/rich-text-demo.md for sample tables, bullet and numbered lists (including nesting), blockquotes, code, and links. Try:

./bin/mdcopy examples/rich-text-demo.md

Then paste into Apple Mail or another rich-text client to confirm formatting.

How it works

The script converts GitHub-flavored markdown to HTML with light CSS (Apple system font, table borders, code styling), then puts HTML on the general pasteboard. Apps that accept HTML from the clipboard will render it; plain-text-only fields will fall back depending on the app.