zendesk-markdown

Convert Markdown text into minified, Zendesk-compatible HTML.

12|2|Updated Feb 23, 2025
One-click install
npx skills add https://github.com/YousefHadder/dotfiles --skill zendesk-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zendesk-markdown
Source: https://github.com/YousefHadder/dotfiles/tree/main/claude/.claude/skills/zendesk-markdown
Command: npx skills add https://github.com/YousefHadder/dotfiles --skill zendesk-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts standard Markdown text into HTML that is compatible with Zendesk's various content areas, ensuring proper formatting and avoiding rendering issues.

Core Features & Use Cases

  • Markdown to HTML Conversion: Accurately transforms Markdown syntax (bold, italics, lists, links, headings, etc.) into valid HTML.
  • Zendesk Compatibility: Generates minified, clean HTML suitable for Zendesk tickets, macros, triggers, and email templates.
  • Use Case: You have a set of troubleshooting steps written in Markdown and need to include them in a Zendesk macro. This Skill will convert the Markdown into correctly formatted HTML that Zendesk will display properly.

Quick Start

Convert the following markdown text to Zendesk-compatible HTML.

Frequently Asked Questions about zendesk-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to HTML for Zendesk tickets?

Converting Markdown to HTML for Zendesk tickets requires transforming standard syntax into minified, Zendesk-compatible HTML. This handles headings, lists, links, images, and code blocks to prevent rendering issues in macros and automations.

Why does my Markdown formatting break when pasted into Zendesk?

Markdown formatting breaks in Zendesk because the platform requires specific HTML rendering rather than raw Markdown syntax. Converting your text into properly escaped, minified HTML ensures that formatting like blockquotes and horizontal rules display correctly.

Can I use Markdown directly in Zendesk macros and automations?

You cannot use Markdown directly in Zendesk macros and automations without conversion. You must convert Markdown text into valid, minified HTML so that Zendesk can properly render text formatting, lists, and links within tickets and triggers.

What is the best way to format troubleshooting steps for a Zendesk macro?

The best way to format troubleshooting steps for a Zendesk macro is to convert your Markdown syntax into Zendesk-compatible HTML. This generates clean, escaped HTML that ensures headings, lists, and code blocks render properly in support tickets.

Does Zendesk support code blocks and blockquotes from Markdown?

Zendesk supports code blocks and blockquotes only when they are converted from Markdown into valid HTML. The conversion process applies specific rules to format these elements so they render correctly within Zendesk tickets and email templates.

What are the limitations of using HTML in Zendesk content areas?

Limitations include potential rendering issues if the HTML is not properly escaped or minified. Converting Markdown to Zendesk-compatible HTML ensures valid output, but complex formatting outside standard Markdown elements may still require manual adjustment.