DTPab

印刷やデザイン、アドビ製アプリやスクリプトなど、雑多な技術ブログ

技術書Lab. Advent Calendar 2025:執筆環境を整える

この記事は、技術書Lab.さん主催「技術書について書く Advent Calendar 2025」に寄せた記事です。

adventar.org


技術書にまつわる記事ということで、何を書こうかと思い浮かんだのはツールとしての執筆環境についてです。皆さんは原稿を書くとき、何を使っていますか? 手書きすることはないと思うので、PCで何かしらエディターを利用していると思います。本記事は、ツールとしての執筆環境について、筆者が利用しているエディターやそれにまつわる機能とサービスなどについてかんたんに紹介したいと思います。

執筆ツールとしてのVS Code

筆者はMacを使っていて、エディターはVisual Studio Codeです*1。VS Codeの利点はいくつかありますが、もっとも大きな理由はさまざまな拡張機能が開発・リリースされているところです。その気になれば自分でも作れます。

ひとつの例ですが、小説家の藤井太洋さんはご自分の執筆環境を拡張機能*2として提供されています。縦書きやルビ表記などにも対応しており、縦書きのままビューワー表示もPDF出力もできたり、原稿用紙風にマス目に入れることもできたり、編集距離という独自概念で自分の作業量を知れたり…といった執筆者ならではの機能がたくさん詰め込まれています。

とまぁ、執筆が生業ではない人間がそこまで心血を注いでVS Codeで文字を書くことは稀かと思いますが、ほかにも「文章を書く」ということに対してさまざまなサポートを行ってくれる拡張機能がたくさんあります。

Markdown書式のススメ

とはいえ、最終的にアウトプットしたい形式(ファイル形式やデータのもちかた、書式など)によって、文章の書き方やファイル・フォルダー構成は検討する必要があると思います。
筆者はMarkdown書式が気に入っていて、原稿はほとんどMarkdownで書いています。というのも、このはてなブログの記法がMarkdown書式ということもありますが、GitHubのreadmeなどさまざまな場面*3で利用できますし、ちょっとした書き方で体裁が統一できるのが気に入っています。

前述のVS CodeにはMarkdownで文章を書く際の補助的な拡張機能がいくつもありますが、筆者が使っているのは主に下記の2つです。

  • Markdown All in One:Markdown書式で文章を書くのに必要な機能がだいたい入っています! 超便利!
  • Markdown Preview Enhanced:こちらはVS CodeのMarkdownプレビューを強化してくれます。どこかにアウトプットするのではなく、VS CodeのMarkdownで完結するようなケースでかなり便利に使えます。

表記の統一

「〜する時」と「〜するとき」のような、いわゆる表記ゆれというのは、読んでいてノイズになりやすく、かつ書いていて統一が取りにくいものです。そこでオススメなのが、下記2つのVS Codeの拡張機能です。

  • テキスト校正くん:ICSメディアさんが提供している、文章構成のための拡張機能。どんな内容をチェックするか、項目ごとにオン・オフできます。
  • Highlight:自分でカスタマイズする必要がありますが、ワークスペース単位で設定すれば媒体などに合わせたオリジナル執筆環境ができあがります。

テキスト校正くんは、その名の通り、一般的な文章として読みやすいあれこれを指摘してくれます。使い勝手としてはプログラミング言語のリンターに近いです*4。
もう一方のHighlightは、正規表現を使って特定の文字列に色を付けたり、文字の背景色を設定したり、ということができる拡張機能です。たとえば、筆者は下記の設定を入れてこの文章を書いています。

"highlight.regexes": {
  "(((?<=する|な|いう)[時方事物為所])|本稿|という|みなさん|様々|色々|等|従う|最も|簡単|(?<!その)他)": [
    {
      "backgroundColor": "#ffa0004d",
    }
  ],
  "(  $|  (?=\n))": [
    {
      "backgroundColor": "#7eac684d"
    }
  ],
  "((((?!.*))|「(?!.*」)|『(?!.*』)|《(?!.*》)|【(?!.*】)|〈(?!.*〉)|[(?!.*])|〔(?!.*〕)))": [
    {
      "color":"#ff0000"
    }
  ]
},

正規表現がわからないと「なんじゃこりゃ?」かもですが、上記は3つの設定が入っていて、下記のような内容です。

  • 形式名詞としての「時・方・事・物」や、「様々・色々・等」など開きたい漢字表記などにハイライト
  • Markdown書式の半角スペース2つで改行する記法にハイライト
  • 起こしカッコがあるのに受けカッコがないとハイライト

上記2つの拡張機能が入っていると、VS Codeではこんな見た目になります。

VS Codeでの見え方

赤い波線はテキスト校正くんによるもの、黄色の背景・末尾のスペース2つのハイライト・起こしカッコの赤文字はHighlightによるものです。こうすると基本的に見落とすことがないので、表記ゆれがかなり減らせます。

おわりに

以上、筆者の執筆環境についてつらつらと書かせてもらいました。執筆環境は基本的に好みで選んでいいものなので、あくまでもひとつの参考意見として読んでいただけたら幸いです。

ちなみに、Markdown書式で文章を書くと、横展開がしやすくなります。筆者はそもそもこのはてなブログの記事をMarkdownで書いていますし、Vivliostyle*5を使って同人誌に仕立てたりもできます。書き慣れると離れられなくなります…(筆者は離れられなくなりました)。

最後に、表記統一について筆者がとても勉強になったサイトと資料を紹介しておきます。

参考文献

*1:一時的なテキストの編集は、起動が早いCotEditorで済ませています。

*2:その名も「novel-writer」。この拡張機能を藤井さんご自身が開発・アップデートされているのです。

*3:2022年にはGoogleドキュメントもMarkdownの一部の書式を利用できるようになり、Markdown書式を入力→即座に反映されます。その後インポートとエクスポートにも対応しました。
参考:
『Googleドキュメントに搭載された「マークダウン」の機能は、こうして使いこなす | WIRED.jp』(2025年12月06日閲覧).
『GoogleドキュメントでMarkdownのインポートとエクスポートが可能に | gihyo.jp』(2025年12月06日閲覧).

*4:『文章作成・メール作成に役立つ! VS Codeの拡張機能「テキスト校正くん」を公開 - ICS MEDIA』(2025年12月06日閲覧).

*5:電子出版を可能にするオープンソースプロジェクトです。公式サイトもありますし、gihyo.jpに連載記事もあります。興味のある方はぜひトライしてみてください! 先述の藤井太洋さんの拡張機能も、PDF出力部分はこのVivliostyleを内部で動かしています。