概要

Nimのプログラムとその実行結果をMarkdownに出力するツールです。
まったく俺得&Adventカレンダーの穴埋め用。

いわゆるサンプルコードとその結果を表示するアレ

sample.nim

echo "hello"

hello

こういうコードと実行結果をいちいち貼り付けるのも面倒だなーと思い、サンプルコードを

そのまま実行するタスク
コードブロックごとにコンパイルして、実行結果（標準出力）を拾い、Markdownを作成するタスク

といった作業をVSCodeのタスクとして用意して、気軽にテストコードの実行＆Markdownを生成するツールを作ってみました。

サンプルコードの形式

サンプルコードは、３つのパートから構成されます。

概要部
import/共通部
コードブロック（複数）

import/共通部と、各コードブロックを結合し、テンポラリファイルへ出力後、nim c -rで実行しています。

以下サンプルコード

# =============================
# overview: NimのXXX処理をコツコツと
# 説明1
# 説明2
# 説明3

# =============================
# imports: インポートモジュール
import json,strutils
import os
const message = "hello"

# =============================
# title: XXXX1処理
block:
    echo "test1 " & message

# =============================
# title: XXXX2処理
block:
    echo "test2 " & message

# =============================
# title: XXXX3処理
block:
    echo "test3 " & message

このソースをMarkdownで出力するとこんなカンジになります。
ブロックの区切りは、# =============================になっていますｗ

# 概要
NimのXXX処理をコツコツと
説明1
説明2
説明3

## 以下メモ

### XXXX1処理

"""nim
import json,strutils
import os
const message = "hello"

block:
    echo "test1　　" & message
"""

"""shell-session
(stdout)
test1 hello
"""

### XXXX2処理

"""nim
import json,strutils
import os
const message = "hello"

block:
    echo "test2　" & message
"""

"""shell-session
(stdout)
test2 hello
"""

### XXXX3処理

"""nim
import json,strutils
import os
const message = "hello"

block:
    echo "test3　" & message
"""

"""shell-session
(stdout)
test3 hello
"""

以下、出力サンプル

どっかで見かけたことありますね。

概要

NimのXXX処理をコツコツと
説明1
説明2
説明3

以下メモ

XXXX1処理

import json,strutils
import os
const message = "hello"

block:
    echo "test1" & message

(stdout)
test1 hello

XXXX2処理

import json,strutils
import os
const message = "hello"

block:
    echo "test2" & message

(stdout)
test2 hello

XXXX3処理

import json,strutils
import os
const message = "hello"

block:
    echo "test3" & message

(stdout)
test3 hello