mathpix-markdown-it 2.0.27 → 2.0.29

package/README.md

@@ -124,6 +124,20 @@ Struck with Hatching text: \xout{Text with hatching pattern!}
 
 ![](doc/images/latex-underline/latex-underline_07.png)
 
+- [Latex lstlisting env](doc/latex-lstlisting-env.md)
+
+```tex
+\begin{lstlisting}[language=C, mathescape]
+/* the following code computes $\displaystyle\sum_{i=1}^{n}i$ */
+
+for (i = 1; i <= limit; i++) {
+  sum += i;
+}
+\end{lstlisting}
+```
+
+![](doc/images/latex-lstlisting-env/latex-lstlisting-env-01.png)
+
 # What is mathpix-markdown-it? 
 
 **mathpix-markdown-it** is an open source implementation of the mathpix-markdown spec written in Typescript.

package/doc/latex-lstlisting-env.md

@@ -0,0 +1,75 @@
+# LaTeX `lstlisting`
+
+Mathpix Markdown now supports LaTeX-style code blocks using
+`\begin{lstlisting}...\end{lstlisting}` — similar to the **LaTeX `listings`** package.
+These blocks allow you to include formatted and syntax-highlighted source code inside Markdown documents.
+
+## Basic Syntax
+
+```tex
+\begin{lstlisting}
+printf("Hello, world!\n");
+\end{lstlisting}
+```
+
+When rendered, this produces a formatted code block, just like a fenced code block in Markdown (```).
+
+## Supported Attributes
+
+You can add optional attributes inside square brackets:
+
+| Attribute    | Example                               |	Description                                                                                                                         |
+|:-------------|:--------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------|
+| `language`   | `\begin{lstlisting}[language=C]`      | Programming language for syntax highlighting. All highlight.js languages are supported (e.g., C, Python, JavaScript, Rust, TeX, bash).	|
+| `mathescape` | `\begin{lstlisting}[mathescape=true]` | Allows inline LaTeX math (`$...$` or `\( ... \)`) inside the code block.                                                               |
+
+## Examples
+
+### Example 1: Basic C Code
+
+```tex
+\begin{lstlisting}[language=C]
+#include <stdio.h>
+int main(void) {
+    printf("Hello, world!\n");
+    return 0;
+}
+\end{lstlisting}
+```
+
+![](images/latex-lstlisting-env/latex-lstlisting-env-02.png)
+
+### Example 2: Inline Math with `mathescape`
+
+```tex
+\begin{lstlisting}[language=C, mathescape]
+/* Compute $\displaystyle\sum_{i=1}^{n} i$ */
+for (i = 1; i <= n; i++) {
+    sum += i;
+}
+\end{lstlisting}
+```
+
+![](images/latex-lstlisting-env/latex-lstlisting-env-03.png)
+
+### Example 3: Inside a Table
+
+```tex
+\begin{tabular}{|l|l|}
+\hline
+Language & Code snippet \\
+\hline
+C &
+\begin{lstlisting}[language=C]
+#include <stdio.h>
+int main(void) {
+  printf("Hello, world!\n");
+  return 0;
+}
+\end{lstlisting}
+\\
+\hline
+\end{tabular}
+```
+
+![](images/latex-lstlisting-env/latex-lstlisting-env-04.png)