WordPressの記事中にユーザーに見えないコメントアウトを埋め込む方法

WordPressで記事を書いていると、こんな場面はありませんか？

後で修正したい箇所のメモを残したい
チーム内で編集意図を共有したい
SEOや構成の戦略メモを記事に紐づけて管理したい

しかし、HTMLコメント（）ではソースを見ればバレてしまうため、完全な非表示にはなりません。

そこで本記事では、フロントにもHTMLソースにも一切出ない内部コメント機能を、ショートコードで実装する方法を解説します。

■ 仕組みの概要
■ 実装手順
1. ① functions.php にコードを追加
2. ② 記事内でコメントを書く
■ 動作結果
■ 活用例
■ 注意点
■ 応用（上級者向け）
1. 管理画面だけで目立たせたい場合
■ まとめ

■ 仕組みの概要

ショートコードを使い、入力は残すが出力は空にすることで、完全非表示を実現します。

■ 実装手順

① functions.php にコードを追加

テーマの functions.php に以下を追加します。

function internal_comment_shortcode($atts, $content = null) {
    return ''; // 何も出力しない
}
add_shortcode('note', 'internal_comment_shortcode');

これで [note]〜[/note] というショートコードが使えるようになります。

② 記事内でコメントを書く

投稿画面で以下のように記述します。

[note]ここは内部メモ：この見出しは後で差し替え[/note]

■ 動作結果

管理画面：コメントは見える
公開ページ：一切表示されない
HTMLソース：完全に出力されない

👉 ユーザーからは完全に不可視

■ 活用例

● 編集メモ

[note]この段落は後でリライト予定[/note]

● SEO対策メモ

[note]ここに内部リンクを追加予定（CV導線）[/note]

● チーム共有

[note]この表現は法務チェック待ち[/note]

■ 注意点

テーマアップデートで functions.php が上書きされる可能性があります
　→ 子テーマでの運用を推奨
エディタによってはショートコードが視認しづらい場合があります

■ 応用（上級者向け）

管理画面だけで目立たせたい場合

function internal_comment_shortcode($atts, $content = null) {
    if (is_admin()) {
        return '<div style="background:#fff3cd;padding:10px;border:1px solid #ffeeba;">'
             . esc_html($content) .
             '</div>';
    }
    return '';
}
add_shortcode('note', 'internal_comment_shortcode');

● 管理画面では黄色のボックスで表示
● 公開ページでは非表示