Readable prose requires variable-pitch font. Readable code requires fixed-pitch font. Org should make it easy to configure the two separately.
mixed-pitch-mode mostly solves this problem, but only advanced users know about it. https://gitlab.com/jabranham/mixed-pitch