RE:CZ

埋め込みTOCと構文税に反対し、コンテンツ作成に集中

コンテンツ管理

👤 コンテンツクリエイター、ブロガー、Markdownユーザー、テクニカルライター、執筆効率やツール最適化に関心のある人々
この記事は、Markdownソースファイルに埋め込みTOCやYAML FrontMatterを組み込む慣行を批判し、これらの構文税が執筆の注意を散漫にし、効率と品質を低下させると論じています。著者は、コンテンツとメタ情報を分離し、ツールで自動的に抽出・処理することで構文税を軽減すべきと主張します。また、デスクトップ端末ではカラムレイアウトやサイドノートなどの最適化が可能であり、インラインコメント機能をサポートしてインタラクティブ性を高めることを提案していますが、原文の変更によるコメント位置のずれ問題の解決が必要と指摘しています。
  • ✨ 埋め込みTOCとYAML FrontMatterは構文税であり、ソースファイルの負担を増加させる
  • ✨ 構文税は執筆の注意を散漫にし、効率と品質を低下させる
  • ✨ コンテンツとメタ情報は分離し、ツールで自動処理すべき
  • ✨ デスクトップ端末はカラムレイアウトやサイドノートに最適化可能
  • ✨ インラインコメント機能をサポートしてコンテンツのインタラクティブ性を向上
📅 2026-01-27 · 1,167 文字 · 約 4 分で読めます
  • 構文税
  • コンテンツ作成
  • TOC
  • Markdown
  • デスクトップ最適化
  • インラインコメント
  • 執筆効率
  • CZON

現在は2026年1月27日、夜です。

コンテンツに集中し、執筆の妨げを減らす

C1さんのブログを見て、彼が埋め込みTOCを使って目次を生成していることに気づきました。

これはMarkdownソースファイルに不必要な負担をかけると考えます。

下図のように、彼は実際のコンテンツを始める前に、構造とメタ情報を約40行も書いています。

C1さんのブログ記事のソースコード

問題は、TOCのソースコードが直接ソースファイルに書かれていることです。メンテナンスには特別なツールがあるはずですが、これではソースファイルがコンテンツとは無関係な「文法税」で溢れてしまいます。 実際、YAML FrontMatterでメタデータを書くことも一種の文法税です。私もこれには断固反対です。しかし、YAML FrontMatterはTOCほど見苦しくないため、以前はこれほど激しく反対はしていませんでした。

私は確信しています。文章を書く際に、スタイル、フォーマット、構造、レイアウトに特に注意を払い始めると、焦点はコンテンツそのものから逸れ、注意力が分散し、執筆の効率と質、ひいてはコンテンツ制作そのものに影響を及ぼします。

人は執筆中、常にこれまで書いた内容を何度も見直しています。もしその内容が様々なフォーマット構文で満たされていれば、人の注意力は分散され、コンテンツそのものに集中できなくなります。

CZONにおいて、コンテンツのメタ情報は、コンテンツ自体に埋め込まれるべきではなく、抽出されるべきです。コンテンツ制作者は、これらのメタ情報を書くことを強制されるべきではありません。コンテンツ制作は断片的に行い、AIとインフラによって統合・レイアウトされるべきです。執筆における「文法税」を減らすことは、CZONの重要な指標の一つです。

モバイルファーストだが、デスクトップではより多くの最適化が可能

モバイル端末では単一カラムのスクロールレイアウトしかできませんが、デスクトップではマルチカラムレイアウトが可能です。 したがって、デスクトップでの読書体験はより良くすることができます。 例えば、ナビゲーションバーや目次バーなどをサイドバーに配置し、デスクトップのワイドスクリーンの利点を十分に活用できます。 さらに、デスクトップでは、脚注をすべて傍注に変更することも可能です。まるで分厚い紙の書籍のように。

長文記事にとって、アンカーも必須の機能です。CZON 0.6.3以降、自動TOC抽出と見出しのアンカー機能をサポートしています。

もっと面白い機能

例えば、インラインコメント機能のサポートです。読者やAIが記事の任意の場所にコメントや議論を追加できるようにします。これはコンテンツのインタラクティブ性と参加感を大幅に向上させることができます。WeChat読書やWeChat公式アカウントは、このような下線付きコメントのインタラクション方式をサポートしています。欠点は、原文が変更された場合、コメントの位置がずれる可能性があり、より安定した位置決め方法が必要になることです。

See Also

Referenced By