Skip to content

inpalpra/TeXicode

Repository files navigation

TeXicode, short for TeX to Unicode, a CLI that turns TeX math expressions into Unicode art.

Post math in Reddit/Discord/Teams or anywhere that supports code blocks. No more LaTeX screenshots or markdown exponents that don't work. Also useful for inserting single line equations into literally any text field.

Quick tutorial for Reddit 1. Visit the [TeXicode website](https://texicode.dx512.com), copy output to clipboard 1. Make a new line in Reddit text field (check line spacing, if there is no line spacing above and below the cursor, it means Reddit does not see it as a separate line) ![Reddit1.png](images/Reddit1.png) 1. Add code block ![Reddit2.png](images/Reddit2.png) 1. Paste ![Reddit3.png](images/Reddit3.png) If the output from TeXicode is a single line, can be placed inline using `Code` instead of `Code Block`

CLI

Install

pipx install TeXicode

Basic Usage

  • txc '\LaTeX' to output Unicode art
    • wrap TeX equation inside single quotes
    • escape expression like f'(x) with f\'(x)
    • \[ \], \( \), $ $, $$ $$, \begin{...} \end{...} is optional
  • cat file.md | txc pipe Markdown content directly (fallback behavior)
  • txc -f - explicitly read Markdown from standard input
  • -h show help message and exit
  • -d enable debug
  • -f <FILE> input Markdown file, see more below
  • -c enable color (black on white)
  • -n use normal font instead of serif
  • unsupported commands will be rendered as ?, or raise an error. If you see these or other rendering flaws, please post an issue, most can be easily fixed.

Rendering Math in Markdown

  • txc -f filename.md to replace TeX expressions in markdown files with Unicode art in text blocks.
  • cat filename.md | txc -n -c pipe markdown directly from other CLI tools.
  • pipe into a markdown renderer like glow for ultimate terminal markdown preview:
    cat example.md | txc -c | glow

Screenshot

Features

  • supports most LaTeX math commands
  • uses Unicode
    • not limited to ASCII characters
    • Unicode italic glyphs are used to differentiate functions from letters, similar to LaTeX
  • works with any good terminal font
    • does not use any legacy glyphs
    • go to src/arts.py, comment/uncomment some parts if your font support legacy glyphs to get even better symbols (actually you can't do that no more i removed the comments...)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors