# Math on GitHub: Following Up

## This page summarizes the projects mentioned and recommended in the original post on news.ycombinator.com #Text #Latex #Markdown #website-generation #Diagrams Post date: 28 Jun 2022

• SonarLint - Clean code begins in your IDE with SonarLint
• Scout APM - Less time debugging, more time building
• SaaSHub - Software Alternatives and Reviews
• ### pandoc

Universal markup converter

I wonder how pandoc[1] does this. You can convert Markdown to PDF (pandoc test.md -o test.pdf), it uses the same syntax as GitHub ($signs only, no backticks) and it fares a lot better than GitHub in a few of the tests outlined in the article[2]. It's not perfect but clearly something better can be done. • ### Franklin.jl (yet another) static site generator. Simple, customisable, fast, maths with KaTeX, code evaluation, optional pre-rendering, in Julia. A few weeks ago I discovered Franklin.jl ([0], [1]). It has direct KaTeX support and I've been pleased with the results. There is no need for adding or tweaking things unlike Jekyll or Hugo. And KaTeX is faster than MathJax in general. • ### SonarLint Clean code begins in your IDE with SonarLint. Up your coding game and discover issues early. SonarLint is a free plugin that helps you find & fix bugs and security issues from the moment you start writing code. Install from your favorite IDE marketplace today. • ### markdown-it-texmath Support TeX math equations with your Markdown documents. Github's implementation is really lazy. There are many much better approaches to precisely this problem. E.g., Jupyter notebooks implement one that has matured in the wild over a decade. There's this very flexible markdown-it plugin that implements anther https://github.com/goessner/markdown-it-texmath, and my version of it here https://github.com/sagemathinc/cocalc/blob/master/src/packag... which I rewrote in typescript with a focus on the same semantics as Jupyter has, but for CoCalc, and I've been working on using unifiedjs to provide more general latex for Markdown (not just formulas) here https://github.com/sagemathinc/cocalc/pull/5982 Parsing math is much easier if you use a plugin to an existing markdown parser, rather than trying to do some hack outside of that (which is what Github probably does, and also what Jupyter does). • ### cocalc CoCalc: Collaborative Calculation in the Cloud Github's implementation is really lazy. There are many much better approaches to precisely this problem. E.g., Jupyter notebooks implement one that has matured in the wild over a decade. There's this very flexible markdown-it plugin that implements anther https://github.com/goessner/markdown-it-texmath, and my version of it here https://github.com/sagemathinc/cocalc/blob/master/src/packag... which I rewrote in typescript with a focus on the same semantics as Jupyter has, but for CoCalc, and I've been working on using unifiedjs to provide more general latex for Markdown (not just formulas) here https://github.com/sagemathinc/cocalc/pull/5982 Parsing math is much easier if you use a plugin to an existing markdown parser, rather than trying to do some hack outside of that (which is what Github probably does, and also what Jupyter does). • ### personal-site A personal site about software development (by idianal) A GitHub bug I recently noticed that seems related: Expected: When a repo's readme is named README (without the .md suffix), it is rendered as plain text. When a repo's readme is named README.md, it is rendered as Markdown. Actual: When a repo's readme is named README (without the .md suffix), the presence of $ causes parts of the file to be rendered as math. For a real-life example, see the readme in https://github.com/idianal/personal-site.

Can someone please point me where I can submit a bug report/issue for this?

• ### keenwrite

Java-based desktop text editor with live preview, string interpolation, and formulas

• ### kroki

Creates diagrams from textual descriptions!

• ### Scout APM

Less time debugging, more time building. Scout APM allows you to find and fix performance issues with no hassle. Now with error monitoring and ﻿external services monitoring, Scout is a developer's best friend when it comes to application development.

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.