Markdown ではなく、PDF を渡す。

エージェントが文書を仕上げ、あなたがレビューして直したあと、エンジニアリング以外の誰か、マネージャー、クライアント、別のチームの人もそれを読む必要が出てきます。彼らは ## や表の縦線が何を意味するかを知る必要はありません。PDF に書き出して、それを代わりに渡しましょう。

レビュー済みの文書を PDF に書き出し、そのファイルを送ってください。どんな環境でも開け、Markdown の知識もインストールも不要で、プレビューで見たときと同じ見た目です。図、表、書式もそのままです。

なぜ .md ファイルをそのまま送らないのか

プレーンテキストエディタで開いた生の .md ファイルには、ページではなく記号が見えます。見出しは #、太字の前後は **、Mermaid 図を囲むフェンスブロックは、図として描画されないままです。Markdown を書かない人には、これらの記号が意図どおりには伝わりませんし、1つの文書のためにビューアを先にインストールしてもらうのも、頼みごととしては大きすぎます。

なぜスクリーンショットでもないのか

スクリーンショットは、複数ページに及ぶかもしれない文書の、画面1枚分を切り取って固定するだけで、検索も選択もできず、圧縮されて何度か転送されるうちにさらに読みにくくなります。PDF は、どんな長さでもテキストと図、改ページをそのまま保ちます。

PDF が得られるもの

受け取る側がすでに持っているもので開けます。プレビュー、ブラウザ、Acrobat、スマートフォンなど、Markdown のツールは一切不要です。
Mermaid 図はコードのままではなく描き込まれ、コードブロックはハイライトを保ちます。
改ページは、見出しがページの下端に一人取り残されたり、表や図が2ページにまたがって切れたりしないよう選ばれます。
MarsDawn アプリから来たものでも、無料のコマンドラインから来たものでも、同じファイルになります。その手順はMarkdown から PDF へをご覧ください。

次に

書き出しに使えるテーマとレイアウト：プレビューテーマと PDF 書き出し。
アプリの代わりに、スクリプトやエージェントから書き出す：AI エージェント向け marsdawn。
なぜ、まず人がその文書を読む必要があるのか：レビューが必要な理由。