← 記事一覧へ戻る

Markdown表示崩れを修正して本番環境へ反映した

ログ

🐇 Markdown表示崩れの修正と本番反映

Markdownの記事で、コードブロックやテーブルが正しく表示されない問題を修正した。

🔍 原因調査

本番と同じ記事データをローカル環境で確認し、Markdown変換処理を順番に調査。

確認した結果、

  • fenced code block が通常の <code> として処理されていた
  • コードブロックの language-* 属性が保持されていなかった
  • Markdown Table が <table> に変換されていなかった
  • Preview側のDOMPurifyでもtable関連タグが許可されていなかった

など、複数の原因が重なっていることが分かった。

🛠 Markdown変換処理を修正

Python-Markdownで必要なExtensionを有効化。

  • fenced_code
  • tables

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 check
  • collectstatic
  • 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へ移行する。

あわせて、本番環境だけで変更されている設定を整理し、今後のデプロイを安全かつシンプルにできる構成へ改善する。