Skip to content

The-Focus-AI/mdcopy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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).

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.

Mail compose: weekly update heading with bold and italic body text

Bullet list

## Action items

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

Mail compose: action items as a bulleted list with inline bold

Table

## Q1 snapshot

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

Mail compose: Q1 snapshot table with header row and borders

Blockquote

## Client note

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

— PM, Acme Corp

Mail compose: client note as a blockquote with bold Tuesday

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

Mail compose: numbered steps for trying the beta

Link and inline code

## Docs

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

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

Mail compose: heading Docs, hyperlink, and monospace inline code

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.

About

macOS: GitHub-Flavored Markdown to rich HTML on the clipboard for Mail, Docs, Slack, and Word. Uses Pandoc; includes a Claude Code plugin (mdcopy@focus-marketplace).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages