エージェント向け Polysh を早期アクセスで提供中。コーディングエージェントがデモを録画し、Polysh が仕上げます。 ウェイティングリストに登録 →

Markdown クリーナー

差分がきれいに出て、リンターにも指摘されない、統一された Markdown になります。

ブラウザツールを読み込んでいます…

Markdown クリーナーでできること

複数の書き手、AI チャット、書き出したメモから貼り付けた Markdown は、*、+、- の箇条書きが混ざり、見出しが段落に詰まり、空行が何行も続きがちです。たいていは表示されるものの、レビューがノイズだらけになり、markdownlint のようなリンターに指摘されます。このクリーナーは、そうしたパターンを 1 つの統一されたスタイルに書き直します。

ドキュメントをコミットする前、2 つの下書きを結合した後、Markdown→HTML 変換で変換する前に使ってください。結果の下の 1 行に変更内容の数が表示されるので、軽い手直しか大きな書き直しかがわかります。

例

入力

#Polysh 2.4 のリリースノート
* 書き出しの高速化
+ 新しい字幕



## 修正
音声のずれを修正しました。

結果

# Polysh 2.4 のリリースノート

- 書き出しの高速化
- 新しい字幕

## 修正

音声のずれを修正しました。

結果の下には「修正したもの:箇条書き 2 個, 見出し 1 個, 空行の修正 3 か所。」と表示されます。3 行の空行は 1 行にまとめられ、各見出しの後に空行が追加されます。

Markdown クリーナーの使い方

  1. Markdown を貼り付けるか、「ファイルを開く」または「例を使う」をクリックします。
  2. 「その他のオプション」を開き、不要な修正をオフにします:「箇条書きの記号をすべて - にする」「スペースのない『#見出し』を修正」「空行を整える」。
  3. 「コピー」または「.md をダウンロード」をクリックします。

知っておきたいこと

  • 番号付きリストの番号の振り直し、長い行の折り返し、__bold__ から **bold** への強調記号の変更は行いません。
  • 箇条書きの記号は - に統一する一方向だけです。* に統一するオプションはありません。
  • パイプの表は変更せずにそのまま通します。ずれた表を揃え直すには、Markdown テーブルジェネレーターに貼り付けてください。

Markdown クリーナーについてよくある質問

Markdown の見出しが表示されないのはなぜですか?

ほとんどの表示環境では # の後にスペースが必要なので、#Setup はプレーンテキストとして表示され、# Setup は見出しになります。クリーナーは、行が見出しに見える場合にそのスペースを追加し、前後に空行も入れます。

箇条書きには - と * のどちらを使うべきですか?

どちらでも機能しますが、リストの途中で記号を変えると、CommonMark の表示環境では新しいリストが始まり、間隔が変わることがあります。1 つに決めてください。スタイルガイドではハイフンが一般的で、このツールもハイフンで書き出します。

Markdown のブロックの間には何行の空行を入れるべきですか?

1 行です。どの表示環境でも、1 行の空行で段落、リスト、見出しが区切られます。余分な空行は出力を何も変えず、ソースを読みにくく、差分も見にくくするだけです。

ChatGPT などの AI チャットからコピーした Markdown を整えられますか?

はい。貼り付ければ、箇条書き、見出しの間隔、空行が統一されます。太字のラベルや絵文字は削除しないので、スタイルガイドで避けている場合は手で編集してください。