本文へ移動
Canvas製品移植性

Markdownとの相互変換は後回しにしない

Inkwellチーム読了時間:3分

ほとんどの文書ツールは、書き出しをおまけのPDFボタンとして扱います。閉じた環境の中で書き、離れるときには、製品が内部で使っていた構造を失った平板な成果物を受け取るだけです。1ページのメモならそれでも構いません。けれども、何年も改稿し続けるつもりの小説やリサーチ資料、チームのWikiにとっては落とし穴です。

Canvasは逆の考え方で作られています。Markdownとの相互変換は、あれば便利な機能ではなく、公開時の必須条件です。原稿を貼り付ければ、種類つきのブロックになります。そのブロックをコピーして外に出せば、またMarkdownに戻ります。見出し、リスト、強調、そして論の組み立てはそのままです。

Markdown ↔ ブロック
情報を保持
これを貼り付け
# 制約とともに取り組むこと

制約は下書きの敵ではありません。文章に**輪郭**を与えます。長い文書で最も難しいのは、それが*何ではないか*を決めることです。

> 作業仮説:書く余地が広いほど、最初の段落に時間がかかります。

- [ ] 第2節のアウトラインを作る
- [ ] 3つの引用を確認する
- [x] 結論の下書きを書く
この形に変換

制約とともに取り組むこと

制約は下書きの敵ではありません。文章に輪郭を与えます。長い文書で最も難しいのは、それが何ではないかを決めることです。

作業仮説:書く余地が広いほど、最初の段落に時間がかかります。

  • 第2節のアウトラインを作る
  • 3つの引用を確認する
  • 結論の下書きを書く
同じ文書を2つの形式で — いつでもMarkdownにコピーして戻せます
Markdownを貼り付ければ種類付きのブロックになり、いつでも構造を保ったままコピーして戻せます

持ち運べることは、ファイルに表れた信頼のかたちこのセクションへのリンク

書き手は、ひとつのアプリでしか開けない形式で痛い目を見てきました。Fountainが脚本の世界で広まった理由のひとつは、.fountainファイルがどのテキストエディターでも読めることです。長い文章のためのツールは、そうした配慮をめったにしてくれません。資料をまとめる専用アプリは、きれいなアーカイブや静的なサイトが必要になった日、あるいはあなたのエディターに住むつもりのない共同作業者が現れた日まで、便利なだけです。

Canvasは文書をブロックとして保存し、そのブロックをMarkdownに変換するので、外に出しても戻しても構造が残ります。離れる許可を求めているわけではありません。ほかのツールや未来のあなたが読める形で、自分の作品を手元に持っておくということです。

それがこの製品の約束です。共同で書く文書はCanvasに置いたままでかまいません。書き出しは、あなたが主導する引き渡しであって、人質の解放ではありません。

比べやすい履歴にはテキストの形が必要このセクションへのリンク

書き手のためのバージョン管理は、変更が読めるときにしか機能しません。中身の見えない保存形式では、保存ポイントのひとつひとつが発掘作業になります。データのかたまりを復元することはできても、何が動いたのかは見えません。Markdownはわざと地味にできています。きれいに比較でき、きれいに保管でき、研究者がすでに使っているツールともうまく付き合えます。

ある章に2つの節が加わり、囲み記事がひとつ消えたなら、その経緯は変更内容の画面で見たいはずです。元のアプリしか理解できないバイナリーの中ではありません。Markdownとの相互変換によって、Canvasは文章を履歴ツールが扱える形に保っています。エンジニアが設定をテキストで持ちたがるのと同じ理由で、9万語の下書きを独自のグラフの中だけに置いておくべきではありません。

履歴は取り込みから始まるこのセクションへのリンク

大事な失敗は「ファイルを取り出せるか」ではありません。「3章がまだうまくいっていた版を失っていないか」です。

原稿をCanvasに取り込んだら、すぐに保存ポイントに名前をつけましょう。「Discordの書き出しから取り込み」「削る前のエージェントの下書き」など、その瞬間がわかる名前なら何でもかまいません。取り込みで警告が出たら、下書きラインで直しましょう。そうすれば、試行錯誤しているあいだも、きれいに取り込んだ状態はそのまま残ります。瞬間に印をつけてから編集する。この習慣こそ、ページに自動保存を後づけするのではなく、ブロックエディターの下にバージョン管理を置く理由のすべてです。

良い取り込みは、一度きりの変換ではありません。何年も生かしていくつもりの文書の、最初の保存ポイントです。

エディターを選ぶときに問うべきことこのセクションへのリンク

CanvasをGoogle Docs、Wiki、あるいは「とにかく動く」メモアプリと比べているなら、初日の慣れやすさで点数をつけるのは間違いです。離れるとき、公開するとき、エディターの外にいる人と共同作業するときに、構造と履歴が生き残るかどうかを問いましょう。

  • すべての見出しをPDFにつぶさずに、きれいなアーカイブを持ち出せるか。
  • 5章の2つの版を、両方とも元のアプリで開かずに比べられるか。
  • 今日書いたものを、未来のツールが読み取れるか。

Markdownとの相互変換は、こうした問いの答えを「はい」に保つための方法です。製品の分担を知りたい方は、Inkwellの各製品は誰のためのものかでPlotとCanvasの違いを、Canvasのガイドでブロック、アウトライン、書き出しを詳しく紹介しています。