Formatting text with Markdown

Have more questions? Submit a request

95 Comments

  • Jonathan March

    Many thanks, @Mayra, works for me (after a hard refresh of the ZD browser tab, of course).

    0
  • Patrisha Renz

    Thanks so much @Mayra, just shared the good news with my team :)

    0
  • Jonathan March

    For the record: Sometime between last Thursday evening and Saturday morning UTC, Zendesk Markdown's handling of inline code changed significantly. Previously, placeholders inside of code text *were* expanded. Afterwards, they were not. This probably makes sense, but it would have been good to have had a heads up. Thanks!

    0
  • Crawford Philleo

    Is there a keyboard shortcut to toggle the Preview look on your ticket comments when formatting with markdown? If not, can one be added somehow?


    Thanks!

    0
  • Jeroen Ritmeijer

    It looks like markdown support has been dropped (today) in favour of a WYSIWYG editor.

    0
  • Toby Roger

    @Jeroen: that shouldn't be happening and we're investigating it for you now. 

    1
  • Chelsea Day

    Markdown is also broken for my team today. Hope this gets resolved soon!

    0
  • Toby Roger

    @Chelsea: we've identified the issue and we're working on a fix. I'm sorry for the disruption. To rectify, head to your account settings and toggle the ticket settings to markdown and your account will switch back to markdown.

    1
  • Mayra Pacheco

    @Chelsea Day Apologies about this. We recently released a change so that all new Zendesk trials are created with the rich text editor. This over applied to a few older accounts that never had a true setting in our database. We're working on reverting this now to ensure all affected accounts go back to their original setting.

    You can immediately change back to markdown by going to the Ticket settings page on your account (/agent/admin/tickets) and changing the setting to markdown. 

    2
  • Chelsea Day

    Thank you for the quick replies! Toggling markdown off, and back on did the trick!

    1
  • Pat Prince

    Can you include a quick notation about how "#123456" will create a link to the URL for Ticket 123456 in whichever instance you're in?  I can't find it in here and would like to be able to point new employees to this article for all the markdown information.  Thanks!

    0
  • Chris Swinney

    @pat - simply doing exactly what you have written above will work

    i.e. In the email reply just add the text #123456, and the reply sent by Zen will add a hyperlink to the text pointing to your ticket at https://<youraccount>.zendesk.com/tickets/123456, or whatever

    0
  • Juana Petit de Meurville

    I've added a link to the agent signature in my org, but the emails that are delivered show the markup instead of just a text with a link. This is what our customers are seeing:

    Need more info? Visit Our [Help Center](http://my-url.com)

    I also see the same in the Zendesk agent, when viewing the ticket.

     

    Is there a way around this? 

    Cheers!

    0
  • Jonathan March

    Instructions should be explicit that all special blocks (code, quote, bullet, list) must be preceded by and followed by a blank line.

    2
  • Pat Prince

    @chris - I know how to make use of the markdown.  I was asking for the markdown to be properly documented in this article, since it seems like a very simple addition and I'd like to send people in my company to this article as a reference rather than having to completely make my own which could fall out of date

    1
  • Jonathan March

    @Pat @Chris Exactly. This is not just a random article in the help center. This *is* the place where a user ends up after clicking the Markdown help link when writing a ticket. 

    0
  • Clayton Waters

    @Jake

    You mentioned that HTML was allowed, but how so?

    I need to copy formatted HTML content and paste it into the box OR I need HTML code to put in the box?

    Thanks!

    0
  • Ryan

    @Clayton --- You would want to include the HTML code within the box. Any code within the Body of the trigger itself will end up rendering -- you should be good to go from there!

     

     

    0
  • Mary Paez

    We were customizing the Welcome message sent to new users of our Portal.  To add hyperlinks to the message we had to use markdown (but I never used it).  I found that to add the hyperlink, instead of embedding HTML I use markdown shown below:

    Please access our [Support Portal](http:/www.xxxxx.com) to become familiar with our KB articles.

     

    QUESTION: Will this change in the future?  Why was markdown chosen over HTML?

     

    0
  • Jessie Schutz

    Hey Mary!

    Originally, markdown was the only formatting option anywhere in Zendesk, including ticket comments, macros, etc. We didn't start changing over to rich text editors in some parts of the product until more recently. I don't have any insight into the decision to use markdown at the start, but this is why you're required to use markdown in certain areas of the product.

    As far as changing the formatting method in the welcome message, the way this part of the product works makes it really complicated to change from markdown to rich text. For the moment, it's not on the road map.

    0
  • Ramil

    Hi, our team reported that markdown e.g. using hyperlinks on our replies to FB messages do not seem to work. Is that really the case or is there a way to make it work for FB and other social media platforms that we support?

    0
  • Nicole - Community Manager

    Hey Ramil - 

    You are correct, markdown and rich text do not work in FB message responses. In order to send a link, your agents will need to send the full url path. Facebook should generate a preview from that link though. 

    0
  • Ramil

    Ah thanks for the info Nicole. Appreciate that. Cheers.

    1
  • Thomas van Dalen

    Does this work in help center? not for me

    0
  • Nicole - Community Manager

    Hey Thomas - 

    Everything in this article is referring to the Support product, not Guide. Can you tell us more about what you're trying to do so we can find the right answer for you? 

    Also, I see that this is your first post. Welcome to the Zendesk Community!

    0
  • Thomas van Dalen

    Sure, id like to have [code] [/code] blocks in the help center where we can post our documentations.

    0
  • Jessie Schutz

    Hey Thomas!

    Can you show me exactly how you're formatting the text? The Code Block should work for you.

    0
  • Thomas van Dalen

    seems to work now thank you anyways. I had to copy the text and insert in message to get it working, tapping ` ` ` ` four times didnt work

    0
  • Jessie Schutz

    I'm glad you got it figured out!

    0
  • Ben S.

    Is there an option for subscript or superscript?

    0

Please sign in to leave a comment.

Powered by Zendesk