Skip to content

Commit

Permalink
Going back to CodeCogs for math blocks
Browse files Browse the repository at this point in the history
GitHub's LaTeX rendering is just not fit for purpose.

When it works it's extremely convenient, but:

1. It's riddled with all sorts of bugs that are frustrating to try to
   work around.

   See https://github.com/nschloe/markdown-math-acid-test for some
   examples. This is after more than a year from release.

   The current pain in my backside is when you have both inline math and
   block math in the same list item? There's no real workaround for this
   so you either have to give up on math blocks or give up on lists.
   Both of these options make the readability of the document worse.

   See https://github.com/orgs/community/discussions/17325 for this
   specific bug.

2. The LaTeX rendering on GitHub is surprisingly ugly?

   It's quite jarring going from other markdown renderers like StackEdit
   to GitHub.

   Some research suggests this might be machine-font related, but I've
   tested on multiple machines, Firefox and Chrome (Chrome is slightly
   better), but the results have always be unsatisfying.

So going back to CodeCogs.

The ghmath2codecogs.py scripts helps with this.

Note the original LaTeX is still accessible in the alt field of the img
links.
  • Loading branch information
geky committed Oct 23, 2024
1 parent db678db commit 0ef1c1d
Show file tree
Hide file tree
Showing 2 changed files with 474 additions and 284 deletions.
Loading

0 comments on commit 0ef1c1d

Please sign in to comment.