The same could be said of markdown as you start embedding Mermaid diagrams or other DSL's, or plain text as you introduce structural conventions. It depends on

The same could be said of markdown as you start embedding Mermaid diagrams or other DSL's, or plain text as you introduce structural conventions. It depends on what you are doing and the complexity that warrants. The least powerful tool that will do the job well is likely a good option.