We could provide code in this repo to automatically format SQL and PL/SQL code in our Markdown files before committing changes. This could be done by using SQLcl and tvdformat.js or the standalone CLI provided in this repo.

Technically every client needs to enable the appropriate Git hook(s). We should just provide the necessary install procedure to simplify that set up process. This could be used as example to set up something similar in other Git repos using SQL and PL/SQL code.

Some code blocks are marked as sql, but contain more than SQL and PL/SQL commands. E.g. output of an execution in SQL*Plus, SQLcl or similar. These code blocks are not amended based on this issue. Instead the default logic will apply. There are simply not formatted due to parse errors. To fix that a dedicate issue can be created (once all these code blocks are identified).