概要
https://qiita.com/fe2030/items/af2dbbad728d41ded7ab
詳細内容
## 【Markdown】AIの出力で「**」がそのまま表示される！？ 太文字が効かない時の原因と対処プロンプト 🤖
https://qiita.com/fe2030/items/af2dbbad728d41ded7ab
AIが生成したMarkdownで強調表示が正しく機能しない問題に対し、日本語と記号の間に半角スペースを挿入するプロンプトとエディタ設定で解決策を提示します。
**Content Type**: 📖 Tutorial & Guide
**Language**: ja
**Scores**: Signal:4/5 | Depth:3/5 | Unique:3/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 80/100 | **Annex Potential**: 75/100 | **Overall**: 76/100
**Topics**: [[AI生成コード, Markdown, プロンプトエンジニアリング, 開発ワークフロー改善, テキスト整形]]
生成AIにMarkdown形式でブログ記事やドキュメントの下書きを依頼した際、「**太文字**」と出力された箇所が、実際にコピペすると「**太文字**」のように記号がそのまま表示されてしまう問題が発生することがあります。著者は、この一見地味ながらも手作業での修正が手間となるストレスフルな現象の原因と、その効果的な対処法を解説しています。
この問題の「意外な原因」は、Markdownが英語圏で生まれた記法であるため、一部の古いパーサーや表示システムでは、記号の直前・直後に半角スペースがないとMarkdownとして認識しないという挙動にあります。AIは強調する記号の使用は理解しているものの、日本語特有の「詰め書き」文化と、半角スペースが必要という細かい仕様までは指示しない限り配慮しないことが多いと著者は指摘します。結果として、文字が詰まった状態で出力され、エディタが正しく認識できないと**がそのまま表示されてしまうのです。
さらに重要な注意点として、QiitaやZenn、VS Codeなどの現代的なMarkdownパーサーは優秀なため、スペースが詰まっていても自動で太文字として表示してくれるケースがあることを挙げ、「自分の環境では問題なく見えても、GitHubのREADMEや社内Wiki、Slack、Notionなど別の場所へコピペした瞬間に表示が崩れる可能性がある」と警鐘を鳴らします。この表示崩れ事故を防ぐためには、やはり日本語と記号の間に半角スペースを入れるのが最も安全な解決策であると強調しています。
解決策はシンプルで、AIへの指示（プロンプト）を変更するだけです。著者は、依頼文の末尾に「出力の際は、日本語（全角文字）と、英数字・記号・Markdownタグ（半角文字）の間に、必ず『半角スペース』を入れてください。」または「和文と欧文・記号の間にはスペースを入れる（分かち書きする）フォーマットで出力してください。」という一文を追加することを推奨しています。これにより、「重要なのは **ユーザー体験** です。」のようにスペースが入った状態で出力され、どのような環境でも確実に太文字として認識されるようになります。
このプロンプトは太文字だけでなく、インラインコード（バッククォート）、取り消し線、リンク記法など、AIが頻繁に利用する他のMarkdown記法でも同様のトラブルを防ぐのに有効です。また、VS CodeやCursorユーザー向けには、PrettierなどのMarkdownフォーマッターや、textlintとそのルールセット（textlint-rule-preset-ja-spacing）を活用することで、保存時に自動でスペースを調整し、さらに強固な対策を講じる方法も紹介しています。
この記事は、AIを活用した開発フローにおいて、Markdown出力の品質を向上させたいと考えるWebアプリケーションエンジニアにとって、実践的かつ具体的な解決策を提供するものです。