# Send Discord Markdown to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "discord-markdown", "name": "Discord Markdown", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/BillChirico/discord-markdown", "canonicalUrl": "https://clawhub.ai/BillChirico/discord-markdown", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/discord-markdown", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=discord-markdown", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/syntax-highlighting.md", "references/templates.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/discord-markdown" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/discord-markdown", "downloadUrl": "https://openagent3.xyz/downloads/discord-markdown", "agentUrl": "https://openagent3.xyz/skills/discord-markdown/agent", "manifestUrl": "https://openagent3.xyz/skills/discord-markdown/agent.json", "briefUrl": "https://openagent3.xyz/skills/discord-markdown/agent.md" } } ``` ## Documentation ### Discord Markdown Formatting Format text for Discord's chat rendering engine. Discord uses a modified subset of Markdown with some unique additions (spoilers, timestamps, subtext, guild navigation). ### Output Presentation — CRITICAL When composing a Discord message for the user, always present the final message inside a fenced code block so the user can copy-paste it directly into Discord with all markdown formatting intact. Why: Claude's chat interface renders markdown (e.g., **bold** becomes bold). If the user copies rendered text, the markdown syntax is stripped and the message loses its formatting when pasted into Discord. A code block preserves the raw syntax. ### How to Present Discord Messages Always wrap the final copy-paste-ready message in a fenced code block with the markdown language tag: \`\`\`markdown # 🚀 Announcement **This is bold** and ~~this is struck~~ and ||this is a spoiler|| > Block quote here -# Subtext footer \`\`\` ### Rules Always use a fenced code block — Triple backticks with markdown language identifier The ENTIRE message goes in ONE block — Everything the user will paste into Discord lives inside a single fenced code block. No part of the Discord message should ever appear outside the block as rendered markdown Explain outside the block — Put any notes, options, or context before or after the code block, never inside it Handle nested code blocks — If the Discord message itself contains code blocks, use four backticks (\`\`\`\`\`\`) as the outer fence so the inner triple backticks are preserved. The user copies everything between the outer fence — the inner triple backticks are part of the Discord message: \`\`\`\`markdown Here's some code: \`\`\`javascript console.log("hello"); \`\`\` Pretty cool right? \`\`\`\` Multiple messages = multiple blocks — If providing alternatives or a multi-message sequence, use a separate code block for each with a label above it Message metadata summary — Always display a metadata summary table immediately after every Discord message code block (see below) Templates too — When presenting templates from the reference files, they should also be in copyable code blocks following these same rules Never partially render — Do NOT put headers, bold text, code snippets, or any other Discord-formatted content outside the code block. If it's part of the Discord message, it goes inside the block. The user should never have to assemble a message from rendered markdown and code blocks ### Message Metadata Summary After every Discord message code block, include a summary table with the following stats: StatDescriptionHow to CountCharactersTotal character count of the messageCount all characters inside the code block. Show as X / 2,000 for chat messages or X / 4,096 for embed descriptionsSectionsNumber of header-delimited sectionsCount all #, ##, ### headers. If no headers, show 0User MentionsUsers mentioned via <@USER_ID> or <@!USER_ID>Count unique <@...> patterns (not role mentions)Role MentionsRoles mentioned via <@&ROLE_ID>Count unique <@&...> patterns. Include @everyone and @hereChannel MentionsChannels linked via <#CHANNEL_ID> or Count unique <#...> and patternsURLsLinks in the messageCount raw URLs and masked links [text](url)Code BlocksCode blocks with language infoIf the message contains fenced code blocks, list languages used (e.g., javascript, bash). Show — if none Format the summary as a compact table directly below the code block: | Stat | Value | |--------------------|----------------| | Characters | 437 / 2,000 | | Sections | 3 | | User Mentions | 1 | | Role Mentions | 1 (@everyone) | | Channel Mentions | 0 | | URLs | 0 | | Code Blocks | — | Notes: For role mentions, parenthetically note if @everyone or @here is included since those ping the entire server For code blocks, list each language, e.g. javascript, bash — or (no lang) if the block has no language identifier If characters exceed 80% of the limit, add a ⚠️ warning If characters exceed the limit, add a 🚫 and suggest splitting the message ### Example Interaction User: "Write me a Discord announcement about a new SDK release that includes code examples" Claude's response should look like: Here's your SDK announcement: # 🚀 Volvox SDK v2.0 — Breaking Changes Hey @everyone — we just shipped **v2.0** of the SDK and there are a few things you need to know before upgrading. ## What Changed The \`createJar\` method now accepts an options object instead of positional arguments: **Before:** \`\`\`ts const jar = createJar("Lunch Spots", ["Chipotle", "Sweetgreen"], true); \`\`\` **After:** \`\`\`ts const jar = createJar({ name: "Lunch Spots", options: ["Chipotle", "Sweetgreen"], allowDuplicates: true, }); \`\`\` ## New: Shake Events \`\`\`ts jar.on("shake", (result) => { console.log(\`🎉 Selected: ${result.option}\`); }); \`\`\` > 💡 Full migration guide pinned in <#dev-resources> Drop questions in <#sdk-support> — <@core-team> is standing by. 🫡 -# v2.0.0 • StatValueCharacters659 / 2,000Sections3User Mentions1Role Mentions1 (@everyone)Channel Mentions2URLs0Code Blocks3 — ts, ts, ts Key: Notice the outer fence uses four backticks (\`\`\`\`\`\`) because the Discord message contains inner triple-backtick code blocks. The user copies everything between the outer fence — inner backticks are part of the message. ### Quick Reference StyleSyntaxRenders AsBold**text**textItalic*text* or _text_textUnderline__text__underlined textStrikethrough~~text~~textSpoiler||text||hidden until clickedInline code\`code\`monospacedBold italic***text***textUnderline italic__*text*__underlined italicUnderline bold__**text**__underlined boldUnderline bold italic__***text***__all threeStrikethrough bold~~**text**~~struck bold ### Emphasis *italic* or _italic_ **bold** ***bold italic*** __underline__ ~~strikethrough~~ ||spoiler text|| ### Combining Styles Nest formatting markers from outside in. Discord resolves them in this order: underline → bold → italic → strikethrough. __**bold underline**__ __*italic underline*__ __***bold italic underline***__ ~~**bold strikethrough**~~ ~~__**bold underline strikethrough**__~~ ||**bold spoiler**|| ### Escaping Prefix any markdown character with \\ to display it literally: \\*not italic\\* \\*\\*not bold\\*\\* \\|\\|not a spoiler\\|\\| ### Headers Headers require # at the start of a line followed by a space. Only three levels are supported. # Large Header ## Medium Header ### Small Header Important: Headers do not work inline. The # must be the first character on the line. ### Subtext Small, muted gray text below content. Useful for footnotes, disclaimers, or attribution. -# This renders as subtext ### Single-line > This is a single block quote ### Multi-line Everything after >>> (including subsequent lines) becomes quoted: >>> This entire block including this line and this line are all quoted ### Unordered Use - or * with a space. Indent with spaces for nesting: - Item one - Item two - Nested item - Another nested item - Deep nested ### Ordered 1. First item 2. Second item 3. Third item Auto-numbering trick: Discord auto-increments if you repeat 1.: 1. First 1. Second (renders as 2.) 1. Third (renders as 3.) ### Inline Code Use \`inline code\` for short snippets ### Multi-line Code Block Wrap code with triple backticks on their own lines: \`\`\` function hello() { return "world"; } \`\`\` ### Syntax Highlighting Add a language identifier after the opening backticks: \`\`\`javascript function hello() { return "world"; } \`\`\` See references/syntax-highlighting.md for the full list of supported languages. Commonly used languages: javascript, typescript, python, csharp, json, bash, css, html, sql, yaml, diff, markdown ### Masked Links [Click here](https://example.com) Note: Masked links work in embeds and some contexts, but regular chat may show a preview. Discord may suppress masked links from bots in certain conditions. ### Auto-linking Discord auto-links any valid URL pasted directly: Check out https://example.com for more info ### Suppressing Link Previews Wrap a URL in angle brackets to prevent Discord from generating a preview embed: ### Timestamps Dynamic timestamps that display in each user's local timezone. Format: FlagOutput StyleExampletShort time4:20 PMTLong time4:20:30 PMdShort date02/08/2026DLong dateFebruary 8, 2026fShort date/time (default)February 8, 2026 4:20 PMFLong date/timeSunday, February 8, 2026 4:20 PMRRelative2 hours ago Example: Event starts That was Tip: Use Math.floor(Date.now() / 1000) or date +%s to get the current Unix timestamp. ### Mentions & References <@USER_ID> → @username mention <@!USER_ID> → @username mention (nickname format) <@&ROLE_ID> → @role mention <#CHANNEL_ID> → #channel link → Browse Channels link → Customize Community link → Server Guide link → Linked Roles link ### Emoji :emoji_name: → Standard/custom emoji <:emoji_name:EMOJI_ID> → Custom emoji → Animated custom emoji ### Discord-Specific Gotchas No nested block quotes — Discord does not support >> for nested quotes Headers need line start — # must be the first character on the line (not inline) Underline is NOT standard Markdown — __text__ underlines in Discord but bolds in standard Markdown Spoilers are Discord-only — ||text|| has no equivalent in standard Markdown Lists need a blank line — Start lists after a blank line or they may not render Embed markdown differs — Some formatting behaves differently in embeds vs chat messages 2000 character limit — Standard messages max at 2,000 characters; nitro users get 4,000 Embed description limit — Embed descriptions max at 4,096 characters Code block language names are case-insensitive — JS, js, and JavaScript all work ### Formatting for Different Contexts Reminder: Regardless of context, always present the final Discord-ready message inside a fenced code block so the user can copy-paste it directly. See "Output Presentation" above. ### Chat Messages Full markdown support. 2,000 character limit (4,000 with Nitro). ### Embed Descriptions Full markdown support. 4,096 character limit. Masked links work reliably here. ### Embed Field Values Limited markdown. 1,024 character limit per field. ### Bot Messages / Webhooks Full markdown support. Same as chat messages. Use embeds for richer formatting. ### Forum Posts Full markdown support in the post body. Title is plain text only. ### Resources Syntax highlighting: references/syntax-highlighting.md — full list of supported languages with examples Templates: references/templates.md — copy-paste templates for common Discord formatting patterns ## Trust - Source: tencent - Verification: Indexed source record - Publisher: BillChirico - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/discord-markdown) - [Send to Agent page](https://openagent3.xyz/skills/discord-markdown/agent) - [JSON manifest](https://openagent3.xyz/skills/discord-markdown/agent.json) - [Markdown brief](https://openagent3.xyz/skills/discord-markdown/agent.md) - [Download page](https://openagent3.xyz/downloads/discord-markdown)