{{ message }}
/ MyST-Parser Public

# Parse labels in LaTeX Math#202

Open
opened this issue Aug 11, 2020 · 3 comments
Open

# Parse labels in LaTeX Math #202

opened this issue Aug 11, 2020 · 3 comments
Labels
enhancement New feature or request

### chrisjsewell commented Aug 11, 2020

 When #201 is merged, direct parsing of latex amsmath environments will be supported 😄 Currently, though it will not do anything with any environments containing \label{name}. It would be good to parse these in a way that they can be referenced correctly by e.g. {eq}name The text was updated successfully, but these errors were encountered:

### chrisjsewell commented Aug 11, 2020 • edited

 If you would like to see this feature implemented leave a 👍 reaction on the comment above (see https://executablebooks.org/en/latest/feature-vote.html)

### bknaepen commented Nov 1, 2020

 I use amsmath environment and equation labeling via \label{name} a lot so I'm definitely interested in this 😀. Here are some observations that I would like to share. In Latex, if an environment line align contains several equations, each of them is numbered by default. For example, \begin{align} a&=1 \label{eq1} \\ b&=2 \label{eq2} \end{align} This is the first label: \ref{eq1}. This is the second label: \ref{eq2}.  is rendered as: If I add this align environment in a myst markdown file, it gets rendered like this when processed through jupyter-books: So only the environment as a whole is numbered, not the individual equations. I am new to JB but if I understand well, this is how sphynx behaves and I have not found info (yet) on how to get the numbering as in the regular Latex output. For parsing the labels, this is where it can be tricky. In Latex, a label can be added to each equation in multiline environments and these may be used separately in \ref{} statements, like in the example above. In JB, if only the whole environment is numbered, this cannot work well, even if there is only one label as it can reference the second equation for example. To be able to use amsmath environments and labels in my jupyter notebooks, I currently use the following workaround: Use on label per environment Place the label directly under the \begin{statement} Using a python script, I then parse the myst markdown files and change all amsmath environments to myst directives with proper labels. Here is an example: \begin{align} \label{mylabel} a&=1 \\ b&=2 \end{align}  becomes {math} :label: eq1 a&=1 \\ b&=2   The python script also changes in the markdown file all the statement like \ref{mylabel} to roles like {eq}mylabel. This allows to have proper referencing of the equations in the final html output. But it won't solve the multiline/multi labels issue as only one label is allowed in this strategy. Using directives, it's not clear to me how to get multiple labels either.

mentioned this issue Nov 22, 2020

### a7p commented Jun 29, 2021

 If you would like to see this feature implemented leave a +1 reaction on the comment above (see https://executablebooks.org/en/latest/feature-vote.html) This issue has a lot of votes, but lacks the enhancement-label, hence it's not in that list.

added the enhancement New feature or request label Jun 29, 2021