Help with Markdown formatting, please

Hello, I have chosen this option for the Project Information Window:

Resolve Markdown formatting for text tokens

So far I have figured out, how to let text appear as italics (by adding * before and after the text).
What is the syntax to let a number appear, like “4.” (without the quotes)?
Thank you for help.

Hi,

Try to type 4\.

6 Likes

There is a Markdown Cheatsheet that has all the options and a reference guide, that might help in learning that syntax

3 Likes

Fantastic, and thank you very much.
I would have never thought of the backward slash. The usual cheat sheets don’t show this option.

1 Like

Thank you Juergen,
a very useful link. Still I did not find that backward slash there. Luckily we have @charles_piano :trophy:

2 Likes

If you create an Italic Character Style, you can use the new token syntax as an alternative.

2 Likes

Backticks also work:

2 Likes

Thank you Ben,
my main issue were the disappearing numbers, if “Resolve Markdown…” was checked.
But yes, being able to get a title or the aria beginning in italics is probably the most used case.

I think the checkbox is a little misleading. If I’m not mistaken, all it really does is let you use * and ** (or _ and __) for italic and bold – it doesn’t interpret headers or lists, or preformatted text.

The issue with the number followed by a period is that Markdown uses that to indicate a numbered list. Dorico won’t render the numbered list, but it also silently swallows the number and period rather than displaying them as is. A backslash is a common “escape” character in programming, instructing the interpreter to render a character literally rather than give it any special meaning. Escaping the period tells the Markdown interpreter that you really want a period, not the start of a list.

It’s not referenced in the cheat sheet, but it is explained here:

@LAE’s suggestion for backticks works because they indicate preformatted text in Markdown. Dorico doesn’t render the text in a monospace font, which is what this usually does in Markdown, but the backticks do prevent the interpreter from trying to create a list.

6 Likes