Visual Studio Codeで記述中

 使ってます。左側がMD記述、右側がView(Browserで見たときのイメージView）

mermaidの記述もOKです。（コパイロットに生成依頼して貼り付けたもの）

フローチャートもOKです。

数式もOKです。

ガントチャート

mermaidの記述は、全てコパイが生成したものを若干修正して使っています。

ドキュメント作成で良いと思うのは、仕様の曖昧さの部分が露呈することだと思います。AIと相談しながら書いているのですが、意図通りにならないということは、仕様記述が甘いということではないかと思います。

MDは、基本テキストファイルなので、LLMが読みやすい、理解しやすいということだろうと思います。数式や構造も読み取れるので、より厳密な記述がし易いと思います。