tex2typst-rs

A Rust library that converts TeX code to Typst code.

Now you can try this library online in the WASM web app (WIP)!

Aim of this project

There exist some other libraries that convert LaTeX (especially LaTeX math) to other languages. However, the result may not be visually pleasing or easy to read. This project aims to convert LaTeX to idiomatic Typst code, which can be very easily read and edited.

For comparison, for this LaTeX input:

\overrightarrow{P M}=(3-x-y) \overrightarrow{P A}+x \overrightarrow{P B}+(y-2) \overrightarrow{P C}

mitex gives the output:

arrow(P  M )= \(3 - x - y \) arrow(P  A )+ x  arrow(P  B )+ \(y - 2 \) arrow(P  C )

tex2typst-rs gives the output:

arrow(P M) =(3 - x - y) arrow(P A) + x arrow(P B) +(y - 2) arrow(P C)

Usage

See the documentation for more details.

Simple example

use tex2typst_rs::tex2typst;
use tex2typst_rs::text_and_tex2typst;

fn main() {
    let tex = r"\widehat{f}(\xi)=\int_{-\infty}^{\infty} f(x) e^{-i 2 \pi \xi x} d x, \quad \forall \xi \in \mathbb{R}";
    println!("{}", tex2typst(tex).unwrap());

    let mixed = r"some text and some formula: \(\frac{1}{2}\)";
    println!("{}", text_and_tex2typst(mixed).unwrap());
}

Output:

hat(f)(xi) = int_(- infty)^infty f(x) e^(- i 2 pi xi x) d x, quad forall xi in RR
some text and some formula: $1/2$

With custom macros

use tex2typst_rs::tex2typst_with_macros;
let tex = r"\R \pp[f]{x}";
let macros = r"\newcommand{\R}{\mathbb{R}}
\newcommand{\pp}[2][]{\frac{\partial #1}{\partial #2}}";
println!("{}", tex2typst_with_macros(tex, macros).unwrap());

With Typst symbol shorthands

let shorthands = vec![
            SymbolShorthand {
                original: "arrow.r.long".to_string(),
                shorthand: "-->".to_string(),
            },
            SymbolShorthand {
                original: "arrow.r.double.long".to_string(),
                shorthand: "==>".to_string(),
            },
        ];
let tex = r"\longrightarrow \Longrightarrow";
let tex_tree = crate::tex_parser::parse_tex(tex).unwrap();
let typst_tree = crate::converter::convert_tree(&tex_tree).unwrap();
let mut writer = crate::typst_writer::TypstWriter::new();
writer.serialize(&typst_tree).unwrap();
writer.replace_with_shorthand(shorthands);
println!("{}", writer.finalize().unwrap());

Acknowledgements

Took inspiration from tex2typst.