The <ruby> HTML element represents small annotations that are rendered above, below, or next to base text, usually used for showing the pronunciation of Japanese and Chinese characters. There is a <ruby> markup syntax discussion in the CommonMark Discussion, among which, I prefer the syntax designed by JuanitoFatas.
[漢字(かんじ)]
[漢字(かんじ)](https://jisho.org/search/漢字)The benefits are obvious:
- The markup looks pretty and easy to understand
- It works well together with links
However, the syntax for separated ruby annotations is a little complex:
[[漢(かん)][字(じ)]](https://jisho.org/search/漢字)While in mistune v3, I've added a ruby plugin for multiple annotations with the below syntax:
[漢(ㄏㄢˋ)字(ㄗˋ)]
[漢(かん)字(じ)](https://jisho.org/search/漢字)You can group all ruby texts in [] which can reduce the use of punctuation characters.
Typlog has been updated with mistune v3, you can use ruby syntax right now in Typlog. Here are the rendered results with the ruby markup syntax:
