English Français العربية

Magzdown Agent Tools

مجتمعي الإنتاجية

Turn Markdown into a shareable link rendered as a typeset document (tables, Mermaid, math, pagination); content is stored in the URL, not uploaded.

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Magzdown agent tools
  2. Install
  3. How the URL works
  4. Links
  5. License

Magzdown agent tools

Your agent writes a report. Instead of dumping markdown in the chat, it hands you a link that opens as a typeset, paginated document. This repo has three ways to teach an agent that: a Claude Code skill, a Cursor rule, and an MCP server.

Install

Claude Code skill
git clone https://github.com/xarl3z/magzdown-agent-tools
mkdir -p ~/.claude/skills
cp -r magzdown-agent-tools/skills/magzdown ~/.claude/skills/magzdown

Per project instead: copy to .claude/skills/magzdown/ inside the repo. Then ask Claude to "open this in magzdown" or "make this report readable".

Cursor rule
mkdir -p .cursor/rules
cp magzdown-agent-tools/cursor/magzdown.mdc .cursor/rules/

The rule is alwaysApply: false; Cursor picks it up from its description when you ask to share or present a document.

MCP server
cd magzdown-agent-tools/mcp
npm install && npm run build
claude mcp add magzdown -- node "$PWD/dist/index.js"

Cursor and Claude Desktop config is in mcp/README.md. The tool is open_in_magzdown({ markdown, title? }) and returns the link. Set MAGZDOWN_AUTO_OPEN=1 to also open it in your browser.

How the URL works

The markdown is the URL. Two bytes (0x01 0x00) go in front of the UTF-8 text, the payload is base64-encoded, made URL-safe (+ to -, / to _, padding stripped) and placed after https://www.magzdown.com/open?md=. The reader decodes it in the browser; nothing is uploaded and no account is needed. Keep documents under about 100 KB or the URL may get truncated. The full spec with a test vector is in shared/encode.md and at https://www.magzdown.com/docs.

License

MIT. Not affiliated with Anthropic, OpenAI or Cursor.

الأسئلة الشائعة

ما هو Magzdown Agent Tools؟

Turn Markdown into a shareable link rendered as a typeset document (tables, Mermaid, math, pagination); content is stored in the URL, not uploaded.

كيف أثبّت Magzdown Agent Tools؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Magzdown Agent Tools مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Magzdown Agent Tools؟

ينشره xarl3z. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.