fabiocolacio / Marker

🖊 A gtk3 markdown editor
GNU General Public License v3.0
836 stars 75 forks source link

Feature request: Allow different Markdown standards #284

Open Esokrates opened 5 years ago

Esokrates commented 5 years ago

I wanted to create markdown files for gitlab using Marker, but I noticed that all mathematical expressions were not rendered in gitlab, since they use a different syntax for math, you can find this here: https://github.com/cben/mathdown/wiki/math-in-markdown

So I would like to request some settings where one could select which syntax to follow.

Mandarancio commented 5 years ago

Hi Esokrates, Math equation are not in anyway a standard of the markdown language, but more an extension/hack/workaround. We already leave the option to use two different libraries to shows the math (you can chose in the settings) and I don't think we will start to support any others.

However GitHub markdown rendering DO NOT support any math rendering so you can not show any mathematical expression in Readme or other github documents. Sorry.

You can find some workaround and discussions in the following links:

Esokrates commented 5 years ago

@Mandarancio Thanks for answering, I understand your decision. Though I think you got a me wrong:

  1. I am not refering to rendering backends, but to the math syntax: Some use $ for inline math code some use something different.
  2. I was not talking about github, but gitLAB, where one can indeed show math in Readme, see https://docs.gitlab.com/ee/user/markdown.html#math
  3. Since there is no standard, I think it's important to support the most common ways math syntax is handled.

Please keep in mind that upstream Gnome uses Gitlab for development, so maybe you could support their syntax for devs?

Allowing an option to treat ```math the same as $$ for example would help a lot.

Mandarancio commented 5 years ago

Hi @Esokrates, Sorry I misread your issue! I should not read my mails before 11! :D

Ok I think it should be possible to make a settings on which markers identifies the start/end of a math equation, both for inline and multiline one. However this must be implemented in the SciDown library. Luckly I am the developer of scidown and I will try to change this.

Cheers! :)