作業メモ
Markdown・表・コードを貼る前に整える手順
Markdownは、貼り付け先によって表、コードブロック、改行の見え方が変わります。先に表データと不可視文字を確認し、必要な形式へ整えます。
表、コード、本文を分けて整える
同じ貼り付けでも、表形式とコードブロックでは壊れやすい点が違います。
表は区切りと列数を見る
CSVやTSVからMarkdown表へ変換する前に、列数と先頭ゼロを確認します。
コードは改行と空白を見る
インデント、改行コード、不可視文字が混ざると、レビューや実行時に差分が読みにくくなります。
次にやること
1. 表データをMarkdownへ整える
CSVやTSVを貼り付け、列崩れやゼロ落ちを確認してから表にします。
- Markdown表ツール
CSV / TSV とMarkdown表を相互変換します。
- CSV列抽出・並び替え
表に出す列だけを選びます。
- 先頭ゼロ落ち防止
コード値を貼る前にゼロ落ちを避けます。
2. JSONやコードを読みやすくする
構造データやコード風テキストは、貼る前に整形して確認します。
- JSON整形
JSONを整形し、構文エラーを確認します。
- Slack・Discord引用整形
引用やコードブロック向けに文面を整えます。
- Markdownリンク一括生成
URLとタイトルの一覧からリンクを作ります。
3. 空白と不可視文字を確認する
貼り付け後に見つけにくい空白、改行、ゼロ幅文字を事前に見ます。
- 改行と空白の整形
余分な空白や改行を整えます。
- 不可視文字の可視化と除去
ゼロ幅スペースやBOMなどを確認します。
- 文字数カウント
文字数やバイト数を見たいときに使います。
詰まりやすい場面
- READMEやIssueに表を貼る前に崩れを避けたいとき
- JSONやコードブロックをチャットへ貼る前に整形したいとき
- 見えない空白や改行差分でレビューが読みにくいとき
まず開くツール
各段階で最初に開くものだけを並べています。
必要なら見るページ
用語や周辺ツールが必要なときだけ使います。
- 文章・テキストカテゴリ
空白、改行、不可視文字、置換のツールを見たいとき。