Claude Code で原稿を書けるようになった人が、最後に必ずつまずくのが note.com への入稿です。
書くのは一瞬なのに、貼るところで毎回1時間溶ける。この記事は、その1時間を消すための話です。

noteに貼った原稿は、こういう壊れ方をします

Claude Code に原稿を書かせました。手元のエディタでは、見出しも表も画像も完璧です。
note.com の本文欄に貼り付けます。そして、こうなります。

画像が1枚も出てこない。エラーも警告も出ない。テキストすら残らずに、跡形もなく消えている。
表が、1つの段落の中に改行で押し込まれた、ただの文字の塊になっている。
有料エリアの目印のつもりで書いたHTMLコメントが、そのまま文字として本文に出ている。しかも課金の区切りにはなっていない。
引用の下にあるはずの見出しが、引用のグレーの箱の中に吸い込まれている。

一度やった人なら分かると思いますが、辛いのはここからです。
どこが壊れたのかを目で探して、noteの画面の上で、手で直していく。
原稿は手元に完成しているのに、noteの画面と往復しながら、同じ文章をもう一度組み立て直すことになります。

そして次の記事でも、また同じところで、同じように壊れます。

下は、まったく同じ内容を note に入れた2つの結果です。

文章は同じです。入れ方が違うだけで、こうなります。

note脳は、崩れる4か所を「貼る前に」潰すClaude Codeスキルです

ここで多くの人が、逆の結論に飛びます。
「note は Markdown を解釈しないから、諦めて手で組み直すしかない」。

これは事実ではありませんでした。

2026年9月6日に実機（Chrome 152 / Windows 11）で確かめた結論は、むしろ逆です。
note のエディタは、貼り付けたプレーンテキストを Markdown として解釈します。

同じ検証で、11,365文字の本文を 1回の貼り付け で投入できました。所要およそ5.8秒。
大見出し19個、小見出し13個、箇条書き9個、引用6個、区切り線1本、段落128個が、
正しいブロックとして構築されています。分割して貼る必要すらありませんでした。

見出し、箇条書き、番号付きリスト、太字、取り消し線、リンク、引用、区切り線、コードブロック。
ここまでは全部、原稿を丸ごと1回貼るだけで通ります。

壊れるのは4か所だけです。画像、表、有料エリア、そして引用の直後。

つまり本当に必要なのは、「noteの画面で手で組み直す作業」ではありません。
「貼る前に、その4か所だけを原稿の側で処理しておくこと」です。

note脳は、その4か所を貼る前に原稿の側で潰し、noteの画面に残る作業を番号つきの日本語の手順書に変える、Claude Code スキルです。

Claude Code に言う言葉は、これだけになります。

この原稿をnoteに入稿したい

実機で確かめた、noteエディタの罠の全リスト

推測は入れていません。すべて2026年9月6日に、実際の note の下書きで1つずつ確かめた挙動です。
スキルの中身は、要するにこの一覧そのものです。

シャープ1つの見出し：大見出し（h2）になる。h1は存在せずh2に降格される
シャープ2つの見出し：大見出し（h2）になる
シャープ3つの見出し：小見出し（h3）になる
シャープ4つ以下の見出し：すべて小見出しに潰れる。noteの見出しは2段階しかない
箇条書き・番号付きリスト：正しく変換される。ネストも保持される
太字・取り消し線・リンク：正しく変換される
引用：引用ブロックになる。ただし直後に罠がある（次章）
区切り線：区切り線になる
コードブロック：コードブロックになる
インラインコード：変換されない。バッククォートが文字としてそのまま残る
表：変換されない。1つの段落に改行で押し込まれる。noteに表ブロックは存在しない
画像のMarkdown記法：跡形もなく消える。テキストすら残らない。いちばん危険
HTMLコメント：エスケープされた文字列として本文に残る

画像の記法というのは、これです。

![alt](images/foo.png)

これを貼っても、noteの本文には何も出ません。空行すら残りません。
「画像を入れ忘れた」ことに気づけないまま公開してしまう事故が起きるのは、これが理由です。

記法以外にも、画面の挙動そのものに罠があります。

ページを開いた瞬間、フォーカスは本文側に当たっています。 タイトル欄をクリックせずに打つと、タイトルのつもりの文字列が本文の1行目になります。
手入力（キーボードで1文字ずつ打つ）だと、行頭の太字がその行で閉じず、次の行まで巻き込むバグが再現します。 だから太字を含む文章は、必ず貼り付けで入れます。
画像をアップロードした直後、カーソルはキャプション欄の中にいます。 そのまま本文を打つと、全部キャプションになります。
キャプションが空のときだけ、Enter で画像の下の段落に脱出できます。
キャプションに一文字でも入れた後は、Enter を何回押しても脱出できません（キャプションの中で改行されるだけです）。マウスで画像の下の行をクリックするしかありません。下矢印キーも Ctrl+End も脱出できないことを確認済みです。
有料エリアの本物の区切りは、「＋」→「有料エリア指定」で入るものだけです。 原稿に「ここから有料」とHTMLコメントで書いても、ただの文字列として本文に出るだけで、課金の区切りにはなりません。
動画ブロックは存在しません。 「ファイル」で動画を添付することはできますが、再生できないダウンロードカードになります。再生させたいなら YouTube などに上げて、「埋め込み」でURLを貼ります。

この一覧を、毎回思い出しながら手で対処するのは無理です。だから原稿の側で処理します。

引用の直後で何が起きるか（分かっている範囲だけ書きます）

冒頭のスクリーンショットの、下半分です。ここは正確に書きます。

引用行の直後に空行がないと、続く行が引用ブロックの中に吸い込まれます。
段落も、箇条書きも、そして大見出しにするつもりだった行すら、変換されずに文字のまま、
グレーの箱の中に押し込まれます。

ただし、この現象には条件があります。分かっているのはここまでです。

1文字ずつ手入力した場合は、確実に再現します。 引用の直後に空行を入れずに次の行を打つと、上のスクリーンショットの下半分の状態になります。
原稿を丸ごと1回で貼り付けた場合は、再現しませんでした。 引用と、その後の見出し・段落・箇条書きは、全部正しく別のブロックに分かれました（スクリーンショットの上半分がそれです）。
ただし、貼り付けで試したのは1パターンだけです。 ですので「貼り付けなら絶対に安全」とは言いません。原稿の書き方や分割の仕方によっては、貼り付けでも起きる可能性は残っています。

この検証結果には、実務上とても大きな意味があります。

手入力と分割貼り付けでは事故が確認されていて、一括貼り付けでは（少なくとも試した範囲では）起きなかった。
これは「本文は分割せず、丸ごと1回で貼るべき理由」の、かなり強い裏づけです。

そのうえで、同梱の変換スクリプトは保険として、引用行の直後に空行を自動で補います。
一括貼り付けでも、あとから手で直すときでも、安全側に倒れるようにしてあります。

出てくるのは3つのファイル。あなたの仕事は「上から順に実行する」だけです

スキルの本体は、SKILL.md（noteエディタの検証済み挙動という知識そのもの）と、
note-checklist.mjs（原稿を変換するスクリプト）です。
スクリプトは Node標準機能だけで動きます。インストールするパッケージはゼロです。

原稿を1本渡すと、出てくるのは3つです。

貼り付け用の本文テキスト … noteの本文欄に 1回で貼り付ける全文。表は箇条書きに変換済み、引用の直後には空行を補完済み、画像・動画・有料エリアの位置は「【画像1】」のような目印の行に置換済み、HTMLコメントは除去済み、インラインコードのバッククォートは剥がし済み、シャープ4つ以下の見出しは小見出しに丸め済みです。
日本語のチェックリスト … 人間がnoteの画面で上から順に実行する、番号つきの手順書。「タイトル欄を必ずクリックしてから打つ」「この文字列を貼る」「この絶対パスの画像を選ぶ」「キャプションを入れたなら Enter を押さずにマウスで抜ける」まで、迷う余地がないところまで書かれます。画像が見つからない場合は、冒頭に警告として出ます。
plan.json … 後述の半自動投稿スクリプト用のデータ（画像の絶対パス、存在確認の結果、有料区切りの有無）。

noteの画面でやることは、毎回この形に固定されます。

タイトル欄をクリックしてからタイトルを入れる
本文欄に、貼り付け用テキストを1回で貼る
「【画像1】」の目印の行を上から順に、実際の画像に置き換える
「【有料エリア】」の目印の行を消して、「＋」→「有料エリア指定」を入れる
プレビューで確認して、下書き保存

判断が要る作業が、ひとつも残っていないのが分かると思います。
考える作業は全部原稿の側で終わっていて、noteの画面に残るのは手を動かすだけの作業です。

実物：このスキルで入稿した有料記事を、そのまま公開します

説明より実物です。

このスキルを使って実際に入稿し、いま公開されている有料記事がこちらです。

https://note.com/sakai_hulahoop/n/n12e20c01f4df

道案内動画エディタというツールを紹介した記事で、
無料部分およそ4,400字＋有料部分およそ4,400字、画像19点、有料エリアありという構成です。

スクリーンショットではなく本物なので、実際に開いて確かめられます。見てほしいのは3点です。

見出しと箇条書きが、最後まで崩れずに並んでいること
画像19点が、本文に漏れずに入っていること（キャプションが本文に混ざっていないこと）
有料エリアの区切りが、意図した位置に正しく入っていること

これが、この記事で売っているものの成果物です。
「うまくいくはずです」ではなく、「もう1本、この手順で世に出ています」という話をしています。

半自動の投稿スクリプトも入っていますが、主役ではありません

ここは正直に書きます。

スキルには note-autopost.mjs という、ブラウザを自動操作する半自動投稿スクリプトも同梱されています。
puppeteer-core を使い、CDP接続でログイン済みのChromeを操作します。

動作は確認済みです。 2026年9月6日、19点の画像を含むおよそ9,900字の原稿で、
タイトル投入 → 本文の一括貼り付け（174ブロック）→ 画像4点の自動挿入（キャプションも正しく
キャプション欄に入り、本文に漏れませんでした）→ 有料エリアの区切り挿入、まで通っています。

そのうえで、スキル自身が「壊れやすい・非推奨寄り」と書いています。 理由も全部書いてあります。

記事が長く画像が増えると、通常のスクロール処理が効かなくなる（実際にスクロールしているのはページ全体の要素で、そこを直接動かす必要がある）
同じタブで何時間も自動操作を続けると、Chromeのレンダラーごと応答不能になる（同じプロファイルでChromeを再起動すれば、ログイン状態を保ったまま復旧します）
離脱やリロードのときにブラウザのネイティブダイアログが出るので、必ず受け流す処理を入れる必要がある
「公開に進む」は絶対に押さない設計にしてある

最初は必ず、画像1枚だけ、あるいは貼り付けまでの空実行で試してください。長時間の連続自動化は避けてください。

この記事は「もうnoteを開かなくていい」という話をしていません。
ここまではツールがやります。ここからは人間がやります。 その線を引くのが、このスキルの仕事です。

できないことも、先に書いておきます

完全自動投稿はできません。 そして、するべきではありません。半自動スクリプトは同梱していますが、上に書いたとおり壊れやすく、主役ではありません。画像の差し込みは、基本的に人間の手でやる前提です。
表は、表のまま出せません。 noteに表ブロックが存在しないためです。スクリプトは箇条書きに自動変換しますが、どうしても表で見せたい場合は、画像にして貼るしかありません。
引用の直後の挙動は、一括貼り付けでは再現しませんでした。試したのは1パターンだけです。 「貼り付けなら絶対に安全」とは言い切れません。スクリプトは保険として空行を補いますが、最後は自分の目で確認してください。
動画は貼れません。 再生できる形にするなら YouTube などに上げて、埋め込みでURLを貼る形になります。
見出しは2段階だけです。 シャープ4つ以下の階層は、原稿でどう書いても小見出しに潰れます。
検証は 2026年9月6日、Chrome 152 / Windows 11 のものです。note.com はエディタを更新することがあります。挙動が違ったときは、空の下書きを1本作って実際に貼って確かめ、SKILL.md を書き換えてください。そうしろ、とSKILL.md自身に書いてあります。
チェックリストの例やコマンドは Windows 表記です。 スクリプト自体は Node だけで動くので macOS や Linux でも動きますが、クリップボードにコピーする1行や、パスの書き方は読み替えが必要です。

向かない人も書いておきます。

noteに記事を投稿しない人
画像も表も有料エリアも使わない、短いテキストだけの記事しか書かない人（この場合、貼るだけで終わります。スキルは要りません）
「全部自動でやってほしい」人（この記事は、その期待には応えません）

同梱されるもの

zip一式に、次の3ファイルがそのまま入っています。

SKILL.md（スキル本体） … Claude Code に入れておくと、「noteに入稿したい」と言うだけで発動します。noteエディタの検証済み挙動が、そのまま知識として入ります。
note-checklist.mjs（変換スクリプト） … 原稿から「貼り付け用テキスト」「日本語チェックリスト」「plan.json」を生成します。依存パッケージゼロ、Node標準だけで動きます。
note-autopost.mjs（半自動投稿スクリプト） … 起動手順、オプション、既知の壊れ方まで SKILL.md に書いてあります（任意。使うなら puppeteer-core が別途必要）。

検証済み挙動の一覧（貼り付けで通る記法と通らない記法、画像キャプションからの脱出手順、有料エリアの正しい入れ方など）も SKILL.md の中にそのまま入っています。

このうち SKILL.md と note-checklist.mjs は、そのまま解凍してすぐ動きます。
外部サービスへの登録も、追加のダウンロードも要りません。

よくある質問

Q. 何が必要ですか？

A. Claude Code と Node.js だけです。note-checklist.mjs は Node標準機能だけで動き、npm install するものはありません。
半自動投稿を試すときだけ puppeteer-core が要りますが、これは任意です。追加費用も、外部サービスの契約もありません。

Q. Claudeのモデルはどれを使えばいいですか？

A. 変換そのものはスクリプト（プログラム）がやるので、モデルの賢さで出力は変わりません。
モデルの差が出るのは、原稿そのものを書く工程です。入稿だけが目的なら、どのモデルでも同じ結果になります。

Q. 専門知識がなくても使えますか？

A. 使えます。実行するのはコマンド1行で、出てくるチェックリストは日本語の番号つき手順です。
「タイトル欄をクリックしてから打つ」「この行を消して＋ボタンを押す」というレベルまで書いてあるので、
noteの画面で迷うところがありません。

Q. 買ったらすぐ使えますか？

A. すぐ使えます。有料エリアの2つのコードブロックをコピーして、指定の場所に2ファイル保存するだけです。
その場で原稿を1本流して、下書きまで持っていけます。

Q. note.com のエディタが変わったらどうなりますか？

A. 変わる可能性はあります。だからこの記事もSKILL.mdも、検証日と検証環境（2026年9月6日 / Chrome 152 / Windows 11）を明記しています。
そして SKILL.md には「挙動が違ったら空の下書きを1本作って確かめ、この SKILL.md を更新すること」という指示が入っています。
Claude Code に「noteの挙動が変わったので確かめて」と頼めば、その手順で更新できます。

Q. 完全自動で投稿できますか？

A. できません。 そして、この記事はそれを目指していません。
半自動スクリプトは同梱していますが壊れやすく、スキル自身が非推奨寄りだと書いています。
このスキルが消すのは「noteの画面で原稿を組み直す時間」であって、「noteを開くこと」ではありません。

Q. 無料で調べられる情報と、何が違いますか？

A. 2つあります。ひとつは 実機で確かめた日付と数字が入っていること（11,365字を1回の貼り付けで投入、
画像のMarkdown記法は跡形もなく消える、キャプションに文字を入れたあとはEnterで脱出できない、など）。
もうひとつは、その知識が読み物ではなく、原稿を変換して手順書を吐くスクリプトになっていることです。

価格は480円です

入っているのは、note脳スキル一式（SKILL.md + scripts/note-checklist.mjs + scripts/note-autopost.mjs）を
まとめた zip ファイル、そして入れてから最初の1本を下書きに入れるまでの手順、この2つです。
解凍して指定の場所に置けば、その場で動きます。

この記事自体も、このスキルで入稿しています。冒頭のスクリーンショットも、
実際に空の下書きを1本作って壊してみたときのものです。

noteの画面で原稿を組み直す作業は、次の1本から、あなたの仕事ではなくなります。