Markdown表示崩れを修正して本番環境へ反映した
🐇 Markdown表示崩れの修正と本番反映
Markdownの記事で、コードブロックやテーブルが正しく表示されない問題を修正した。
🔍 原因調査
本番と同じ記事データをローカル環境で確認し、Markdown変換処理を順番に調査。
確認した結果、
- fenced code block が通常の
<code>として処理されていた - コードブロックの
language-*属性が保持されていなかった - Markdown Table が
<table>に変換されていなかった - Preview側のDOMPurifyでもtable関連タグが許可されていなかった
など、複数の原因が重なっていることが分かった。
🛠 Markdown変換処理を修正
Python-Markdownで必要なExtensionを有効化。
fenced_codetables
Bleach側でも必要なHTMLタグ・属性を許可し、サニタイズを維持したままMarkdownを表示できるように修正した。
Preview側のDOMPurifyについても、table関連タグを許可するよう変更。
🧪 テスト追加
今回見つかった問題についてテストを追加。
- fenced code blockが
<pre><code>へ変換されること - コードブロックのlanguage情報が保持されること
- Markdown Tableが
<table>へ変換されること
既存テストも含めて実行。
80 tests ALL GREEN ✅
🎨 Tableの表示調整
Markdown Table自体は表示できるようになったものの、罫線がなく読みにくかったためCSSを追加。
記事詳細と入力中PreviewのMarkdown領域だけを対象にして、
- 罫線
- セルの余白
- 見出し背景
- テーブル幅
を調整した。
🚀 本番環境へ反映
GitHubへpush後、VPSへ反映。
その際、本番環境ではローカルと異なり、
- PostgreSQL
- 環境変数によるSECRET_KEY / DB設定
- Gunicorn
- STATIC_ROOT
などの本番専用設定がVPS側に存在していることを再確認。
本番設定をバックアップ+stashへ退避してから最新版をpullし、本番設定を復元した。
その後、
manage.py checkcollectstatic- Gunicorn再起動
systemctl status- ブラウザでの表示確認
まで実施。
CSSが更新されない問題があったため、collectstatic --clear でstaticファイルを再収集して解消した。
✅ 結果
- コードブロック表示:OK
- language情報:OK
- Markdown Table:OK
- Table CSS:OK
- Preview:OK
- 80 tests:ALL GREEN
- Gunicorn:active (running)
- 本番表示:OK
無事、本番環境まで修正完了 🐇✨
📝 次回
ローカルはSQLite、本番はPostgreSQLという構成になっているため、次回はローカル環境もPostgreSQLへ移行する。
あわせて、本番環境だけで変更されている設定を整理し、今後のデプロイを安全かつシンプルにできる構成へ改善する。