fletcher / fletcher/MultiMarkdown-5

mmd2tex math delimiters

Open
#16 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
C
Stars
296
Forks
50
PR merge metrics
No merged PRs in 30d

Description

Hi, I mentioned this before in the mmd support forum, but it was buried in another issue I was talking about (related to LaTeX math environment `$$\begin{align)...`). In the hindsight I should have separated the 2 issues. I hope you don't mind I kind of repeat it here:

Currently, in mmd2html and mmd2tex, this is how the math delimiter is translated:

| MMD Source | HTML Output | LaTeX Output |
| --- | --- | --- |
| `$...$` | `\(...\)` | `$...$` |
| `$$...$$` | `\[...\]` | `$$...$$` |
| `\\(...\\)` | `\(...\)` | `$...$` |
| `\\[...\\]` | `\[...\]` | `\[...\]` |

The proposal is simple:

| MMD Source | HTML Output | LaTeX Output |
| --- | --- | --- |
| `$...$` | `\(...\)` | `\(...\)` |
| `$$...$$` | `\[...\]` | `\[...\]` |
| `\\(...\\)` | `\(...\)` | `\(...\)` |
| `\\[...\\]` | `\[...\]` | `\[...\]` |

Reasons:
1. the `\(...\)` and `\[...\]` delimiters are preferred in LaTeX, and `$$...$$` might cause errors with some ams packages.
2. so that the HTML output and LaTeX output are identical as far as math delimiter is concerned

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.