MARKDOWN EDITOR
文章・表・図を手元で整え、技術文書として仕上げる。
システム解析で生まれる文章・表・図を、検査可能な仕様書・運用資料・調査報告書へまとめるため、 当社が実務に合わせて開発し、日々の調査業務で使用しています。
これは製品の販売ページでも、配布ページでもありません。 MarkNext は当社が自社の業務のために開発して使っているアプリです。ダウンロード配布や一般向けサポートは行っていません。 このページは「どういう成果物を、どういう手段で仕上げているか」をお見せするためのものです。
Excel や DB から得た表を整え、コード生成図と自由配置図を一つの長大文書へまとめ、 章の構成を崩さずに組み替え、検査して PDF・HTML・SVG へ仕上げる。
仕様書のないシステムを調べると、形式の違う情報が大量に集まります。 プログラム、データベース、画面、帳票、運用手順、聞き取りメモ、構成図。 これを一本の文書にまとめるまで、道具を持ち替えずに進められます。
ソースと実際の出力表示を左右に並べ、書きながら仕上がりを確認します。
Excel やデータベースの結果を貼り付けて並べ替え、項番を振り直し、Markdown の表に戻します。
コードで描いた図や手描きの構成図を、同梱の draw.io で読みやすい配置に直します。
見出しの番号、字下げ、改ページ、フォント、ページ番号を「スタイル」としてまとめ、文書ごとに切り替えます。
目次を専用画面で開き、節を子節ごと動かします。確定するまで本文は変わりません。
図が本当に描けるか。見出しやリンクや番号が揃っているか。図が紙の幅に収まるか。納品前にまとめて確かめます。
同じ文書から PDF・自己完結 HTML・複数ページの HTML サイト・図の一括 SVG を書き出します。
Markdown の表は、書き始めるのは簡単です。けれど列を増やす、行を入れ替える、番号を振り直すとなると、 とたんに手間になります。調査で出てくる表は、画面項目定義もテーブル定義も帳票項目も、どれも数十行。 ソースでは縦棒が並ぶばかりで、桁も揃いません。本文はテキストのままでよいので、直すときだけ表計算のように扱えれば十分です。
その表の上で右クリックすると、表計算のような編集画面が開きます。 Excel やデータベースの結果を範囲ごと貼り付け、CSV・TSV を読み込み （現場から出てくる Shift_JIS のファイルもそのまま読めます）、最大3キーで並べ替え、 項番を振って Markdown へ戻せます。「書き込む」を押すまで、文書は変わりません。
現場から出てくる CSV は、いまも Shift_JIS のことがあります。文字化けを直してから読み込む手間が要らないよう、そのまま開いて表に取り込めます。TSV も同じで、表計算ソフトやデータベースの照会結果は範囲ごと貼り付けられます。
図にできるのは、流れや構造だけではありません。商品コードの現物と、信号の前後関係。 どちらも仕様書に載せたいのに、これまでは別の道具で作った画像を貼り込んでいました。 文中に値を書けば、その場で図になります。値を直せば図も直ります。
JAN（EAN-13）・ITF-14・GS1-128・NW-7・郵便カスタマバーコード・QR コードなど100種類以上を、 値を書くだけで描きます。JAN は12桁を書けば検査数字を計算し、書かれた検査数字が誤っていれば納品前の検査で示します。 販売管理や物流の仕様書で使います。
信号がいつ変わるか、電文のどのビットに何が入っているか。 流れ図では書けないものを、短いテキストから描きます。 シリアル通信、PLC の入出力、割り込みの前後、固定長レコードの桁割りなど、 古いシステムの調査で必要になるものです。
どちらもこの端末の中で描かれ、外部へ内容を送りません。
流れや状態のように、規則で描ける図は文中にコードで書けば足ります。 一方、機器の並びや画面遷移の全体像のようにどこに何があるかが意味を持つ図は、 自動では思うように並びません。MarkNext はどちらも扱えます。
Markdown の文書に draw.io の図を入れられます。帳票の様式や機器の並びのように、どこに何があるかが意味を持つ図に使います。
.drawio.svg で保存。後から何度でも描き直せます。
調査の成果物は、画面数と項目数がそのまま行数になります。数 MB・数万行になることも珍しくありません。 私たち自身、調査の途中で文書が重くなり、書き足せなくなったことが何度もありました。
MarkNext なら、この大きさでも編集を続けられます。ソース・編集画面・プレビューは、 表示を切り替えても同じ場所が出ます。実際に同じ規模の文書で、開く・編集する・保存する・読み直す、 という一連の動きを自動で確かめています。
調査報告書では、仕上げ段階で章の順序を組み替えることが多く、長い範囲の切り貼りが事故につながります。 ソース上で切り取って遠くへ貼り付ける操作は、範囲を一行間違えれば文書全体に響きます。
MarkNext では目次を専用画面で開き、節を上下に動かし、深さを変えます。子節は一緒に動きます。 変更後の構成を確認してから一括で反映するので、確定するまで本文は変更されません。
仕様書は番号で読まれます。「3章の2の(1)」と指されて、そこを開けなければ話が進みません。 ところが番号は、章をひとつ入れ替えるだけで全部ずれます。MarkNext は番号を二通りに扱えるようにしました。
スタイルで形式を選ぶと、PDF や HTML に番号が付きます。本文は見出しの文字だけのまま。 章を入れ替えれば番号も付け直されるので、振り直しの作業がそもそも起きません。
形式は ISO（1.1.1）、ピリオド付き、日本語慣用（第1章／1-1）、日本の法令、 欧文アウトライン、米国の法令など。文書のタイトルを一段として数えるかも選べます。
Markdown のまま渡す相手には、番号が文字として入っていないと困ります。 「見出しの番号を振り直す」で本文へ書き込み、「番号を外す」で文字だけに戻せます。
どちらも実行前に、変わる行が全部並びます。押すまで文書は書き換えません。 途中から末尾までを対象にすることもでき、それより上の見出しは数えるだけで触りません。
同じ考え方で、箇条書きの番号（(1)／①／a.）も三段まで形を決められます。 表の項番は、表編集の「連番を貼る」で列ごとに。 見出しの深さに応じて本文を字下げする設定もあり、番号と字下げはどちらも「スタイル」の一部として、 文書ごとに切り替わります。
文書健全性チェックでは、文書内の図をすべて実際に描かせたうえで、見出しの構造、アンカー、リンク、表、番号、 そして印刷したときに図がページ幅へ収まるかを確かめます。どれも読み返せば気づくことですが、章が増えるほど見落とします。先に一覧にしておけば、直すかどうかを一つずつ判断できます。
文書全体を書き換える操作の前に、指定した文書だけスナップショットを残せます。 戻すときもいったんエディタへ読み込むだけなので、保存しない限り元のファイルはそのままです。
表紙、ヘッダーとフッター、ページ番号、見出し番号まで付けて、そのまま渡せる形で出します。
画像も図も一枚に埋め込みます。読むのに外部接続は要りません。
章ごとに分けて、左に目次を置きます。社内ポータルへそのまま置けます。
文書内の図を、節名を付けてまとめて書き出します。配布用に編集データを外すこともできます。
見出しの番号、字下げ、改ページ、書体といった体裁は「スタイル」としてまとめ、文書ごとに切り替えます （詳細）。
仕様書のないシステムを調べると、プログラム、データベース、画面、運用手順、調査メモ、構成図と、 形式の異なる情報が大量に出ます。これを一つの技術文書にまとめるのが、仕事の後半です。 そこで要る機能——数万行を開いたまま書き続ける、表を表計算のように直す、図を draw.io で描き直す、章を組み替える、 納品前に通しで検査する——が全部揃った道具は、見つかりませんでした。 無いなら作る、というだけの話です。
同時に、これは当社の技術のデモでもあります。MarkNext は、公開されている MarkText を土台に、 必要な機能を足しながら版を重ねてきました。
公開されたものへここまで手を入れるには、中身を仕様の水準まで 読み解く必要があります。読めなければ、大きな改造も作り替えもできません。裏を返せば、読み解けたから ここまで手を入れられた、ということです。
何がどう動いているかを、根拠とともに書き出す。そこまで解析して報告するのが当社の仕事です。 扱うのは古い技術だけではありません。MarkNext 自体は Electron・TypeScript・Vue・WebAssembly で 動いています。
.drawio.svg として保存されます。通常は draw.io の窓の外部通信を遮断しています。外部との通信について：通常の編集、表の操作、Graphviz の作図、同梱した draw.io は、いずれもこの端末の中だけで動きます。 外部へ出るのは PlantUML の描画と、文書に書かれた外部画像の取得だけで、どちらも設定で切り替えられます。