
【実録#12】noteに勝手なハッシュタグが付く原因と対処法|犯人はCSSの#だった
公開したばかりの自分の記事を開いたら、見覚えのないハッシュタグが20個も並んでいました。
#0d0a24 #1a1a2e #f5f5f5 …。
意味のわからない英数字の羅列です。設定した記憶は一切ありません。むしろ、自分でちゃんとしたタグを付けたつもりでいたのに、それが影も形もなく消えている。代わりに、こんな宇宙人の暗号みたいなタグがびっしり並んでいる。最初に見たときは、正直「乗っ取られたのか?」と一瞬本気で疑いました。
この記事は、こんな人に向けて書いています。
noteに身に覚えのないハッシュタグが付いて困っている人
コードやCSSを記事に貼ることが多いエンジニア系の書き手
「原因不明の現象」を、感覚ではなく証拠で潰すデバッグの進め方を知りたい人
結論から言うと、犯人は私自身が記事に貼ったCSSのカラーコードでした。📌
そして調べていくうちに、もう1つ別の問題まで見つかります。「最初に立てた仮説が、まるごと間違っていた」という話でもあります。同じ罠を踏む人が一定数いるはずなので、調査の過程をそのまま、遠回りも含めて残しておきます。きれいに一発で正解にたどり着いた武勇伝ではなく、思い込みで半日溶かした記録です。
正直に言うと、原因がわかったあとは「なんだ、そんなことか」という話です。でも、渦中にいるときは、その「そんなこと」が全然見えない。デバッグの面白さも難しさも、たいていそこに集約されています。答えを知ってから振り返ると一本道に見えるのに、知らずに歩いているときは分かれ道だらけ。だからこそ、答えだけでなく「どう迷ったか」を残す意味があると思っています。次に同じ霧の中を歩く人にとって、地図より「ここで迷いやすい」という注意書きのほうが役に立つこともあるからです。
「APIのバグだろう」という最初の思い込み

私はnoteへの記事投稿を半自動化しています。仕組みの詳細は実録#4で書いていますが、ざっくり言うと、原稿を用意するとプログラムが下書きを作ってくれる、という運用です。タイトルも本文も、決まったフォーマットのテキストファイルを置いておけば、あとはコマンド一発で下書きが出来上がる。毎日投稿を「気合い」でなく「仕組み」で回すための土台です。
その投稿フローの中で、私はハッシュタグもプログラムから設定しているつもりでした。「#AI」「#自動化」みたいなタグを、コード側で渡していたのです。記事ごとに共通タグ+固有タグを合成して送る、という地味だけど便利な処理を組んでありました。
ところが、実際に公開された記事を見ると、指定したはずのタグが付いていない。代わりに、あの謎の英数字タグがずらりと並んでいる。
このとき私が最初に立てた仮説はこうでした。
> 「投稿に使っているプログラムが壊れていて、変な文字列をタグとして送ってしまっているに違いない」
つまり自分の投稿プログラムのバグだと決めつけたわけです。エンジニアあるあるかもしれませんが、「自分のコードが悪い」と思うと、そこばかり疑ってしまいます。しかも今回は自作の自動化スクリプトです。「最近いじったし、どこかでデグレったんだろう」という思い込みが、さらに拍車をかけました。
でも、ここが落とし穴でした。あなたも「不具合が起きたとき、真っ先に疑う場所」が決まっていませんか?「どうせあのライブラリだろう」「どうせ自分のあの処理だろう」と。その思い込み自体は経験則として有用なこともあります。経験を積むほど「当たり」の勘は鋭くなる。ただ、その勘が当たり続けるからこそ、外れたときに「いや、絶対ここのはずだ」と粘ってしまう。経験は武器であると同時に、視野を狭める枷にもなります。ベテランほど、自分の勘を疑う訓練が要る。今回の私は、まさにその枷にハマっていました。はずれていたときに抜け出すのが一番遅れるのが、この「真っ先に疑う場所」の罠です。
実際、私はこのあと「自分のコードのどこがおかしいのか」を延々と探して、まったく見当違いの場所を掘り続けることになります。タグを送る処理にログを仕込み、送信直前の値を何度も目視し、「ちゃんと正しい文字列を送れているのに、なぜ反映されないんだ」と首をひねる。今思えば、この時点で見るべきは「送る側」ではなく「受け取られた結果」だったのです。📌
証拠を並べたら、仮説が崩れた

行き詰まったので、いったん手を止めて「事実」だけを紙に書き出しました。思い込みで進めると沼にハマる、というのを過去に何度もやっているからです。頭の中だけで考えていると、都合のいい仮説に引っ張られて、同じところをぐるぐる回ってしまう。だから物理的に書き出して、感情と事実を分離します。
書き出した事実はこうです。
謎のタグはすべて # + 6桁の英数字、という形をしている
その英数字に、なんとなく見覚えがある
自分の投稿プログラムは、そんな文字列をどこからも生成していない
3つ目がポイントでした。自分のコードを上から下まで見直しても、#0d0a24 のような文字列を生成している場所が一箇所もない。バグだとしても、存在しないものは送れません。ここで「投稿プログラムが変な文字列を送っている」という仮説が、一気にあやしくなりました。
そして1つ目と2つ目。「6桁の英数字」で「見覚えがある」。#0d0a24 を声に出してみて、ようやく気づきます。
これ、CSSのカラーコードだ。
問題のタグになっていた英数字は、全部「色の指定」だったのです。#0d0a24 は濃い紺色、#1a1a2e は少し明るい紺、#f5f5f5 はほぼ白。私がその記事に貼っていた、画像生成まわりのコードサンプルに含まれていた色そのものでした。アイキャッチや章扉カードを自動生成する話を書いたとき、デザインのCSSをコードブロックでそのまま載せていたのです。
つまり謎のタグの正体は、記事本文に貼ったコードの中のCSSカラーコードだったわけです。
ここで最初の仮説、「投稿プログラムのバグ」が完全に崩れました。タグを生成していたのはプログラムではなく、記事の本文そのものだったのです。自分が一番疑っていなかった「ただ貼っただけのコードブロック」が真犯人だった。
余談ですが、「声に出して読む」というのは、私のデバッグの中で地味に効くテクニックの一つです。目で #0d0a24 を眺めているときは、ただの記号の列にしか見えませんでした。でも「シャープ・ゼロ・ディー…」と口に出した瞬間、「これ、色だ」と体が先に気づいた。黙読していると脳が読み飛ばす情報を、音にすると拾えることがあります。詰まったときほど、変数名やログを一度声に出してみる。コストはゼロなのに、意外とブレイクスルーになります。
事実を並べる、というのは地味な作業です。でも、感覚で「たぶんコードのバグ」と思い込んでいた状態から、「色コードが原因らしい」という確かな足場に移れたのは、間違いなくこの紙に書き出した5分のおかげでした。デバッグで一番もったいないのは、手を動かす時間ではなく、間違った方向に全力で走っている時間です。立ち止まって事実を並べる5分は、間違った方向に走る2時間より、ずっと価値があります。ではなぜ、本文に書いた色コードが「ハッシュタグ」に化けたのか。次はそこを詰めます。あなたなら、この時点で原因の見当がつきますか?
なぜ本文の文字列がタグになるのか

CSSの色コードは、ご存じのとおり # から始まります。#0d0a24 のように。
そして、noteのハッシュタグも # から始まります。#AI のように。
この「先頭の#」が完全にかぶっていたわけです。📌
人間が見れば、#0d0a24 は「色」で #AI は「タグ」だと一瞬で区別できます。文脈で読んでいるからです。でもプログラムからすると、どちらも「# で始まる文字のかたまり」でしかありません。色か、タグか、その意味の違いは文字面には書かれていない。だから機械的に処理すると、両方とも同じ「#付きトークン」として扱われてしまう余地がある。
私が立てた次の仮説はこうでした。
> 「note側が、本文に含まれる "#で始まる文字列" を、ハッシュタグとして自動的に拾っているのではないか」
もしそうなら、CSSカラーコードが20個タグ化された説明が一気につきます。#0d0a24 も #1a1a2e も、note側からすれば「#で始まる単語」にしか見えません。色のつもりで書いた #f5f5f5 が、機械的に「f5f5f5というタグ」として抽出される。私の記事には色指定が20個ほど入っていたので、それがそのまま20個のタグになった、と考えるとつじつまが合います。
仮説は立ちました。でも仮説のままでは記事に書けません。「つじつまが合う」と「実際にそうである」は別物です。「たぶんそうだろう」で止めず、実際にそういう挙動になっているのかを確認することにしました。ここで止めて「たぶん色コードのせいでした」と書いてしまうのが、いちばんやりがちな手抜きです。でも、その「たぶん」がまた外れていたら、読んだ人を巻き込んで二次被害になる。
ここが今回いちばん時間をかけたところです。そして、ここが「自分のコードのバグ」を疑っていた最初の数時間とは違って、ようやく正しい方向に進み始めた瞬間でもありました。仮説が当たっているかどうかより、「検証できる形に仮説を落とせた」こと自体が前進でした。
エディタの裏側の挙動を確認する

noteの編集画面は、いわゆるWebアプリです。ブラウザの中で動いているプログラムが、書いた文章を保存したり公開したりしています。私たちが「投稿」ボタンを押したとき、裏側ではいくつもの処理が走っている。
こういう「中身が見えない箱」の挙動を確かめたいとき、私が大事にしているのは「入力と出力だけで仮説を検証する」という姿勢です。箱の中の実装を完全に理解しようとすると、いくら時間があっても足りません。そうではなく、「こういう本文を入れたら、こういうタグが出てくるはず」という予想を立て、その通りになるかだけを見る。ブラックボックスは、開けようとせず、外から叩いて反応を見る。これだけで、たいていの「なぜ?」は十分に詰められます。
その「編集画面の中で動いているプログラム」が、公開のタイミングで何をしているのか。ここを丁寧に観察していきました。具体的な手順や内部の細かい仕組みは、note側のサービスに踏み込みすぎるので伏せますが、確認したかったのは1点だけです。
公開するとき、本文から "#で始まる文字列" を自動で拾い出してタグにする処理が、本当に存在するのか。
結論として、その処理は存在していました。📌
編集画面は、記事を扱うタイミングで本文テキストをスキャンして、# から始まるトークン(単語のかたまり)をハッシュタグの候補として抜き出す挙動を持っていました。これが「本文に書いた覚えのないタグが付く」現象の正体です。仮説が、ただの想像ではなく、観察された事実に変わった瞬間でした。
私の場合は、画像生成コードに含まれていたCSSカラーコードが、ことごとくこの「#で始まる文字列」に該当してしまった。だから20個も並んだわけです。色を1個書くたびにタグが1個増える、という理不尽な対応関係になっていた。
ここで腑に落ちたのは、この現象はバグではなく仕様だったということです。note側は「本文中の#付き単語=書き手が付けたいタグ」という親切心で拾ってくれている。普通の書き手にとっては、文中に #散歩日記 と書けば自動でタグになる、便利な機能なのでしょう。ただ、コードを貼るエンジニアにとっては、その親切が真正面から裏目に出る、という話でした。便利機能と地雷は、立場が変わるだけで入れ替わる。
この「外から見たら親切、ある立場からは地雷」という構造は、ソフトウェア全般でよく見かけます。たとえば、入力された文字列を気を利かせて自動変換してくれる機能は、普通の人には便利でも、厳密な値を扱いたい人には事故のもと。「賢い自動処理」は、賢いがゆえに、こちらの意図を勝手に推測して上書きしてくる。今回のタグ自動抽出も、まさにそのパターンでした。便利機能を疑う、というのも一つのデバッグ視点です。「これ、よかれと思って何か変換してない?」と。
あなたがもしコードやCSSをnoteに貼る人なら、# で始まる文字列が本文にいくつ入っているか、公開前に一度数えてみてください。カラーコード、URLのフラグメント、シェルのコメント、Markdownの見出し記法、プログラムの行コメント。# は意外なほど色々なところに潜んでいます。それがそのままタグ候補になり得ます。コードを多く貼る記事ほど、この地雷原は広くなります。
もう1つの問題:黙って無視されていたタグ

さて、最初の現象(謎のタグ20個)の原因はわかりました。でも、思い出してください。
私はそもそも「自分で指定したタグが付いていない」ことに気づいて調査を始めました。謎のタグが付く問題と、指定タグが付かない問題。私はこの2つを最初は同じ1つの問題だと思い込んでいたのです。「謎タグが正しいタグを上書きしているんだろう」と、勝手に1本のストーリーにまとめていた。
でも実際には、まったく別々の2つの問題でした。📌
謎のタグは「本文の自動抽出」が原因。一方、指定したタグが付かないのは、投稿プログラム側の渡し方の問題でした。原因のレイヤーがそもそも違う。片方はnote側の仕様、片方は自分のコードの不備。これを1つの問題として扱っていたから、「謎タグを消せば正しいタグが出てくるはず」という、的外れな期待をしていたのです。
調べてみると、私のプログラムはタグを渡しているつもりで、note側が受け取れない形式で渡していました。やっかいなのは、間違った形式で渡してもエラーが返ってこなかったことです。
エラーが出れば「あ、形式が違うんだな」と気づけます。真っ赤なエラーメッセージほど、デバッグにおいてありがたいものはありません。失敗を失敗として教えてくれるからです。でもnote側は、受け取れない形式を黙って無視していました。リクエスト自体は成功扱いで返ってくる。ステータスも正常。なのに、結果だけタグが付いていない。エラーも警告も出さず、ただ静かに何も起きない。だから私は長いあいだ、タグを設定できていないことに気づけなかったのです。
「エラーを返さず、黙って何もしない」。これは個人的に、いちばん怖いタイプの不具合だと思っています。失敗が成功のような顔をして通り過ぎていくからです。テストも通る、ログにも異常はない、APIも200を返す。すべてが「うまくいっている」と言っているのに、ユーザーから見える結果だけが間違っている。こういうのは、気づくきっかけそのものが存在しない。
明確なエラーは、ある意味で優秀なアラートです。「ここがおかしいですよ」と場所まで教えてくれる。対して「黙殺」は、アラートが一切鳴らない火事のようなものです。煙にも気づかず、燃え終わってから「そういえば焦げ臭かったな」と思い出す。私が今回タグの不在に気づけたのも、たまたま謎タグ事件をきっかけにタグ欄をまじまじと見たからで、それがなければ「タグを付けているつもり」のまま何ヶ月も走り続けていたはずです。偶然に救われただけ、というのが正直なところで、これは仕組みの勝利ではありません。だからこそ、こういう静かな失敗は、偶然ではなく仕組みで検知できるようにしておきたい。送った結果を読み返して照合する、という地味な一手間を、今後は標準にすることにしました。
正しい渡し方そのものは特定できました。詳細は伏せますが、ほんの小さな違いです。その小さな違いを満たしていないと、リクエスト自体は成功するのに、タグだけがすっぽり消える。そういう挙動でした。たった一文字、たった一段階のネスト、そういうレベルの差で、成功と「黙殺」が分かれていたわけです。
2つの原因を切り分けてから直す

原因が2つに分かれたので、対処も2つに分けました。ここで焦って両方いっぺんに直そうとすると、どちらが効いたのか分からなくなります。両方同時に変更して直ったとしても、「結局どっちが原因だったのか」が永遠にわからない。次に同じことが起きたとき、また一から悩むことになります。1つずつ潰すのが、遠回りに見えて結局いちばん早いです。
1つ目、謎のタグ(本文自動抽出)への対処。
これは幸い、一度消したタグは再抽出されない作りになっていました。つまり手動で消せば、同じタグが復活することはない。一度きりの掃除で済む。すでにオーナー側(私です)で削除済みだったので、再発の心配はありませんでした。
そして今後の予防として、コードを含む記事を公開するときは、公開直前のタグ欄を必ず目視する、というチェックを習慣にしました。# を含むコードなんて世の中に山ほどあるので、これは仕組みで完全に潰すより、「最後に人間が一目見る」を運用に組み込むほうが現実的だと判断しました。自動化を突き詰める私でも、ここは「目視1秒」をあえて残しています。コストの低いチェックは、無理に自動化しないほうが手がかからないこともある。
2つ目、黙って無視されていたタグへの対処。
こちらは投稿プログラムを直しました。タグを渡すときに、note側が受け取れる正しい形式へ自動で整えてから送るようにした、という内容です。これでプログラムから狙ったタグを付けられるようになりました。一度正しい形式がわかってしまえば、修正自体はあっけないものでした。時間がかかったのは「直す」ことではなく「どこをどう直せばいいか特定する」ことだった、というのも毎度の教訓です。
ついでに、すでに公開済みの過去記事にもタグを付け直せる小さなツールを用意しました。#副業 #AI #自動化 といったタグを、実録#2や#3など過去の無料記事に後付けで設定しています。一度仕組みを作ってしまえば、過去の取りこぼしもまとめて回収できる。これが自動化の気持ちいいところです。
ここで1つだけ気をつけたことがあります。有料記事には自動でタグ付けしないようにしました。有料記事は構造がデリケートで、本文を更新する処理が有料部分を壊すリスクがあるからです。これは別の機会に痛い目を見て学んだ教訓で、今回は最初から「有料記事には触らない」と決めて設計に組み込みました。一度やらかした事故を、設計のデフォルトに反映しておく。同じ穴に二度落ちないための、いちばん確実な方法です。
「気をつける」だけでは、人間はいつか必ず忘れます。だから「気をつける」を「そもそも触れない仕組み」に変える。有料記事を処理対象から外しておけば、私がうっかり全記事一括処理を走らせても、有料記事は最初から対象に入っていない。注意力に頼るのをやめて、構造で事故を防ぐ。これは自動化全般にも言えることで、「人間が注意するルール」より「間違えようがない作り」のほうが、長い目で見て圧倒的に手がかかりません。私の根っこにある「将来手のかからない方法を選ぶ」という基準は、こういうところにも効いてきます。
この事件から持ち帰った3つの教訓
たかがハッシュタグ、されどハッシュタグ。半日近く溶かした事件から、別の場面でも再利用できそうな教訓を3つ残しておきます。💡
1つ目。「自分のコードのバグだ」という思い込みを、いったん疑う。
私は最初、迷わず自分のプログラムを疑いました。でも真犯人は、記事本文に貼ったCSSカラーコードでした。原因は意外と「コードの外」にあることがあります。入力データ、設定ファイル、外部サービスの仕様。事実を紙に書き出して並べた瞬間に、思い込みの仮説が崩れて前に進めました。「真っ先に疑う場所」を持つのは効率的ですが、外れたときに固執しない柔らかさもセットで必要だ、という話です。
2つ目。1つの現象に見えても、原因は複数あると疑う。
「謎のタグが付く」と「指定タグが付かない」を、私は1つの問題だと思い込んでいました。実際は無関係の2つでした。症状を一括りにすると、片方を直しても直らず、「直したのになぜ?」と混乱します。症状ごとに切り分けて、それぞれ別の原因かもしれないと疑うだけで、見通しが一気に良くなりました。バグ報告を受けるときも、「それは本当に1つの不具合ですか?」と一度立ち止まる価値があります。
3つ目。「黙って無視する」挙動はいちばん怖い。
エラーを返してくれる不具合は、まだ親切です。怖いのは、間違った入力を受け取っても成功したふりをして、結果だけがこっそり欠ける挙動です。今回のタグ無視がまさにそれでした。自分でAPIや外部サービスを相手にするコードを書くときは、「成功したように見えて、実は何も起きていない」を常に疑い、できれば結果を一度読み返して検算する。送りっぱなしにせず、「本当に反映されたか」を確認する一手間が、こういう静かな事故を防ぎます。
この3つに共通しているのは、どれも「技術力」より「態度」の問題だということです。難しいアルゴリズムを知らなかったわけでも、特殊なツールが足りなかったわけでもない。ただ、自分の仮説を疑わなかった、症状をまとめてしまった、結果を確認しなかった。つまり、もっと注意深く構えていれば防げたものばかりです。デバッグの上達というのは、知識を増やすこと以上に、こういう「転びやすい姿勢」を一つずつ矯正していくことなのかもしれません。派手なテクニックより、地味な構えのほうが、結局たくさんの時間を救ってくれます。
あなたが最近ハマった不具合は、この3つのどれに近かったですか?
まとめと次回予告
謎のハッシュタグ事件、犯人はこうでした。
20個の謎タグ = 本文に貼ったCSSカラーコードが、note側の「#で始まる文字列を拾う仕様」でタグ化された
指定タグが付かない = 投稿プログラムの渡し方が惜しくて、黙って無視されていた(これは別問題)
対処 = 公開前のタグ欄を目視 + プログラムの渡し方を修正 + 過去記事へのタグ後付けツールを用意
「楽するために自動化する」と言いつつ、その自動化の足元でこういう地味な事故が起きます。派手な大障害ではなく、ハッシュタグ20個という、笑い話みたいな小さな事故。でも、こういう転びかたを1つずつ言語化して潰していくのが、結局いちばんの近道だと思っています。事故そのものより、「なぜ気づけなかったのか」を残すことに価値がある。
🎯 目標は、note月10万円。そのために投稿まわりの自動化を、うまくいった話だけでなく、事故も含めて全部記録していきます。きれいな成功談より、転んだ記録のほうが、たぶん誰かの役に立つので。
📅 次回は、自動投稿パイプラインの別の改善ネタを予定しています。コードを貼る系の書き手がハマりやすい話を、もう少し掘り下げます。
ここまで読んでいただきありがとうございました。スキを押してもらえると、次の記事の燃料になります。同じく「#で始まる文字列」に泣かされたことがある人は、ぜひ教えてください。あなたの「黙って無視されていた」エピソードも、よかったら聞かせてください。
◀ 前回: 【実録#11・ストア審査】Chrome拡張がNGになった。提出前自己監査スクリプトを作った話
📚 シリーズ全話はまとめマガジンへ
https://note.com/lazy_engineer/m/m03a726b1673c