Colors look good to me except the yellow braces - they’re a bit distracting. On Hexdocs the braces are text color (light gray), and I think that looks better.

For the docs overall, the font size is way too big and the column width is too wide. Both look about perfect to me on Hexdocs, so I would just grab what they use and that would help a lot with readability.

Also, there is a typo in the code for “Expression Longhand Syntax” (closing brace). I was going to link the line but I can’t actually find the repo for the site (is it closed?) so hopefully you find it!

Oh and this is definitely not highlighting-related (sorry), but you should probably add anchors to the sections on each page. A simple “#” next to each section title (preferably hide unless hovered) should suffice.

Thanks for the feedback and bug report @garrison!

The missing curly brace is now fixed. About the yellow braces - currently I’m using yellow for all curly braces, though they’re part of a planned nesting-based color system where different nesting levels will have distinct colors (similar to IDE themes), with yellow appearing at level 3 of nesting. I’ll probably prepare a few different variants and make a poll, as I know sometimes people hesitate to share critical feedback directly.

I appreciate the font size feedback from Hexdocs - that’s a good reference point for readability. And yes, section anchors are coming soon! Actually planning to add a nice fixed sidebar on the right showing the current page’s contents.