甲州計算機に付属するコマンド koshu-markdown.sh は、
甲州記法で書かれたスクリプトを実行した結果をマークダウン文書にまとめます。
その文書は、koshu コマンド (甲州計算機) の入力となるスクリプトの内容と、
出力結果の対を含んでいるので、入出力リストとよばれます。
koshu-markdown.sh には，3 つの実行方式があります。
(1) 甲州スクリプトを引数に与える方法，
(2) *.k に対して入出力を一覧する方法，
(3) 甲州スクリプトの一覧をファイルで提供する方法です。
つぎのコマンドは、ファイル calc.k と
A.k を甲州計算機で実行し、
ファイルの内容とその出力を A.md に保存します。
koshu-markdown.sh calc.k A.k > A.md- このコマンドは 3 つの節
calc.kA.koutputを作成します。
ひとつのディレクトリに A.k B.k C.k のように、
複数のデータ・ファイルがある場合は、
-g (glob) オプションを与えて *.k を一覧した文書をつくれます。
その結果を README.md に保存します。
koshu-markdown.sh -g calc.k > README.md- このコマンドは 4 つの節
calc.kA.kB.kC.kを作成します。A.kB.kC.kは、それぞれの出力結果も含みます。
計算式を含むスクリプト calc.k へ与えるデータが、
*.k という単純なパターンで表現できないときは、
そのデータ・ファイルを一覧したファイル ARGS を用意し、
-f オプションへ与えます。
その結果を ARGS.md に保存します。
koshu-markdown.sh -f ARGS calc.k > ARGS.mdARGSがA.kとB.k C.kという 2 行からなるとき、 このコマンドは 3 つの節calc.kA.kB.k C.kを作成します。A.kB.k C.kは、それぞれの出力結果も含みます。
甲州記法のスクリプトは、通常、拡張子 .k がついていますが、
もし、異なる拡張子のときは -x (extension) オプションを使って指定します。
koshu-markdown.sh -x ksh -g calc.k甲州計算機 koshu の代わりに、-p (program)
オプションを使うことで、ほかのプログラムを与えられます。
たとえば、wc であれば、出力結果は、行数、単語数、バイト数になります。
koshu-markdown.sh -p wc -g