目次 (11)
ブログ紹介 – エディター
こんにちは。初めてのブログ記事です。
私は、プログラミングをしながら悩み、解決してきた過程を記録して共有するためにブログを作りました。文章を書くのは得意なほうではありませんが、修正・補完しながら効率よく知識を共有できるようにしていきます。
今回の記事では、私が自分で作ったブログエディターを紹介しようと思います。
1か月近くさまざまなエディターを試した結果、最終的にProseMirrorベースのTiptapを選びました。
Tiptapは
拡張性に優れていて
ViewerをJSON/Textどちらの形式でもSSRできる
Next.js & バックエンドとの相性が良い
エディター | SSR | 拡張性 | エンジン | WYSIWYG | Markdown | RIch Text | その他 |
|---|---|---|---|---|---|---|---|
editor.js | 🟡 | ↗️ | 独自 | ✅ | 🟡 | ✅ | ドキュメントが良い。Json構造。 |
react-md-editor | ❌ | ➡️ | 独自 | ❌ | ✅ | ❌ | WYSIWYGの使い勝手が悪い。 |
toast UI | ❌ | ⬇️ | ProseMirror | ✅ | ✅ | ✅ | ドキュメントが不十分。プラグインが少ない。 |
quill | 🟡 | ↗️ | Delta | ✅ | 🟡 | ✅ | ドキュメントが良い。JSON構造。 |
TipTap | ✅ | ↗️ | ProseMirror | ✅ | 🟡 | ✅ | ドキュメントは普通。機能がきちんと分かれている。 |
ProseMirror | ✅ | ⬆️ | 独自 | ✅ | ❌ | 🟡 | ドキュメントは最高。学習コストが高い。 |
👉 結論:シンプルな機能が中心ならQuill/Editor.jsがおすすめです。しかし、カスタム機能がたくさん必要ならTiptap/ProseMirrorが最適でしょう。
1. 機能の定義
私のエディターに必要な機能を整理してみました。
基本的なテキスト編集機能
書式の変更(太字、下線、斜体、文字色、背景色)
箇条書き、番号付きリスト、チェックリスト
段落の左揃え、右揃え、中央揃え
Markdown記法のサポート(#を入力してスペースを入れるとh1タグ.. ```jsと入力するとjsのコードブロックを自動生成)
インデント、アウトデント
ハイパーテキストの作成
Viewerのサーバーサイドレンダリング
Viewerはサーバーサイドレンダリング(SSR)が可能なので、Next.jsのISR、SSGでキャッシュできる
コードブロックとコードハイライト
コードブロックに設定したプログラミング言語に合わせたシンタックスハイライト
Code Syntax HighlighterはSSRが可能なので、Next.jsのISR、SSGでキャッシュできる。
基本のSyntax Highlightが適用されたコードに書式を追加。(蛍光ペン、下線など)
VS Codeからコピーしたコードは、そのファイルの言語を自動で検出してコードブロックを生成
画像のアップロードと管理
画像の配置とサイズ調整機能をサポート
コピー&ペーストするだけで手軽にS3へアップロードし、URLを受け取って使用
アップロード時にWebPに圧縮してから比較し、効率の良いフォーマットを使用。
既存の画像URLを再利用して、不要なアップロードを防止。
目次(TOC)の自動生成
見出しから目次(TOC)を自動生成
先頭のスラッシュ・ドラッグでの自動補完
「/」を入力すると、主な機能を使える。
内容をドラッグすると、ドラッグした範囲に必要な機能を使える。
2. 機能紹介
6つの機能を実装するなかで苦労した点と実装方法を簡単に紹介します。
2.1 Code Syntax Highlighter
開発理由:開発ブログなので、さまざまな言語のコードハイライトが必須
実装:Shikiベース、100以上の言語をサポート、Line単位でパース → Line numberの処理が可能
特徴:コードブロックに蛍光ペン・下線
・取り消し線のようなマークも適用可能。VS Codeからのコピペで言語を自動検出。苦労した点:ProseMirrorのSchema/Markの衝突を解決 → 2週間以上かかった
成果:エディターと一体となって動作(エディターのコンテキストと連動)、データの二重保存が不要

2.2 Viewerのサーバーサイドレンダリング
開発理由:Next.jsのISR/SSGキャッシュによる高速なレンダリング
考えた方式:
クライアントからHTMLを渡す → セキュリティ上脆弱になりうる。
サーバーでSSRによりデータのパースとSanitizingを行う → 最新の状態を反映、安全
実装:サーバーでのデータ保存とパースしたHTMLのキャッシュを併用 → 高速に出力でき、安全
メリット:セキュリティの強化、データの重複保存が不要
2.3 画像アップロード

開発理由:S3ストレージへのリアルタイムな画像アップロードが必要。
実装:クリップボードから貼り付け → WebPに圧縮 → S3にアップロードしてURLを返す
苦労した点:外部URLの扱い方とCSP設定についての悩み
メリット:既存URLの再利用 → 重複アップロードを防止
2.4 基本的なテキスト編集機能
![]() | ![]() |
実装:Tiptapのプラグインを形式に合わせて開発
苦労した点:機能を追加するには、ProseMirrorのドキュメントまで参照する必要がある。
メリット:いつでも機能を追加することで、装飾の自由度を広げられる。
2.5 TOC

開発理由:ナムウィキの目次から目的の場所へ移動できる機能がうらやましかったから。
実装:
HeadingプラグインにTOC用のdata-attributeを追加し、それを活用してパース。
ResizeObserverでLayoutの変更を検知し、Debouncingを適用して最適化。
苦労した点:パースする方式で実装したため、エディターのHeadingプラグインの実装内容を知らないとメンテナンスが難しい。
メリット:目次をひと目で確認でき、目的の場所を探せる。
2.6 先頭のスラッシュ・ドラッグでの自動補完
![]() | ![]() |
開発理由:Notionのエディターを参考にしてみたところ、十分に良さそうだったから。
実装:
幸い基本的なプラグインがあったので、そのプラグインを活用
独自に追加したい機能をプラグインに追加。
苦労した点:Commandをすべて把握したうえで追加する必要があるが、コードブロックはゼロから作った機能なので、コマンドを自分で追加しなければならなかった。
メリット:マウスをコントロールボックスまで動かさなくて済むので便利。
3. その他の機能
3.1 Iframe (CodePen)
開発理由:いつかはコードの動作まで見せられるようにしたいので、CodePenを活用すると良さそうだと思ったから。
実装:
iframeを適用するとセキュリティの問題が起こりうるので、CSPを適切に使用。
苦労した点:完全にThird Partyなので、CSPの影響を大きく受けるが、実際の環境でのテストが難しい。




