Markdown入力

処理済み出力

Markdown改行ツールとは?

Markdown改行ツールは、Markdownで最も混乱しやすい動作のひとつである改行ルールを処理するためのユーティリティです。プレーンテキストやワードプロセッサとは異なり、Enterキーを押すと新しい行が作成されますが、Markdownでは単一の改行はスペースとして扱われます。これは、他のソースからテキストをコピーしたり、折り返されたコンテンツを貼り付けたり、改行を考慮してフォーマットされたファイルを操作したりする際に、予期しないフォーマットを引き起こす可能性があります。改行ツールは、必要な場所にハード改行を追加したり、折り返されたコンテンツをクリーンな段落に正規化する作業を自動化します。

改行に関する混乱はMarkdownの改行仕様に起因しています。HTML <br> タグとしてレンダリングされる改行を作成するには、行末に2つのスペースを置いた後に改行するか、改行前にバックスラッシュを置く必要があります。あるいは、空行(連続する2つの改行)で新しい段落を作成できます。これはほとんどのエディターとは異なり、単一の改行が「新しい行」を意味するため、Markdownに移行する際のフォーマットエラーの頻繁な原因となります。改行ツールはこれらの問題を手動で修正する労力を省きます。

改行ツールは2つの主要なワークフローをサポートしています。「ハード改行を追加」はソースの単一改行を別々の行としてレンダリングすべき場合に使用し、「段落を正規化」は折り返されたテキスト(1つの段落にまとめるべき複数の行)を適切な段落構造にまとめる場合に使用します。プラットフォームやコンテキストによって異なるアプローチが必要なため、両方のシナリオを処理できるツールがあれば時間を節約し、ストレスを解消できます。

Markdown改行ツールの使い方

ハード改行を追加したり段落を正規化するには以下の手順に従ってください。各ステップはこのページの実際のコントロールを使用します。

1

貼り付け、アップロード、またはサンプルを読み込む

左側のMarkdown入力パネルにMarkdownを貼り付けます。モードを選択します:ハード改行を追加(各行を別々にレンダリング)または段落を正規化(折り返しテキストをまとめる)。サンプルをクリックして改行を含むサブスクライバーAPIドキュメントの例を確認できます。

2

処理済み出力を確認する

右側の処理済み出力パネルに結果が表示されます。ハード改行は末尾のスペースを追加し、正規化は折り返し行を段落にまとめます。CommonMark改行ルールに準拠しています。

3

コピーまたはダウンロード

コピーまたはダウンロードをクリックして出力を使用します。クリアで最初からやり直せます。すべての処理はブラウザで実行されます。

実際の使用場面

詩やスクリプトをMarkdownに変換

詩、歌詞、スクリプト、コード例には各行が意味を持つ意図的な改行が含まれることがよくあります。これらをMarkdownに変換する際、単純に貼り付けると改行構造が失われます(単一の改行がスペースになる)。「ハード改行を追加」モードを使用して、レンダリング出力で各行を別々の行として保持します。

ワードプロセッサコンテンツのクリーンアップ

Microsoft Word、Google Docs、その他のワードプロセッサからテキストをコピーすると、改行がMarkdownの期待と一致しないことがよくあります。テキストは意図した段落区切りではなく、エディターの列幅で折り返される場合があります。「段落を正規化」モードを使用してこれを修正し、折り返し行をまとめながら本来の段落構造を保持します。

メールから貼り付けたコンテンツの修正

メールクライアントはさまざまな列幅で改行を挿入するため、メールコンテンツをMarkdownに貼り付けると乱れが生じます。このツールはフォーマットを正規化し、人工的に折り返された行を適切な段落に変換します。長いメールメッセージをドキュメントやブログにコピーする際に特に便利です。

異なるプラットフォーム向けにコンテンツを準備

異なるプラットフォーム(GitHub、Stack Overflow、Discord、Slack)では改行の処理が異なります。このツールを使用して、対象プラットフォームで正しく機能するようにコンテンツを前処理できます。コンテンツを一度作成し、プラットフォーム固有の要件に合わせて処理し、単一のソースから異なる出力を維持できます。

よくある質問

ソフト改行とハード改行の違いは何ですか?

Markdown用語では、「ソフト改行」は行末に2つのスペース(またはバックスラッシュ)を置いて作成される改行で、HTML <br> タグとしてレンダリングされます。新しい段落を開始せずに視覚的な改行を作成します。「ハード改行」または段落区切りは空行(連続する2つの改行)を使用し、HTML <p> タグを作成します。CommonMarkの改行仕様でこれが正確に定義されています。

Markdownが単一の改行をスペースとして扱うのはなぜですか?

この設計は、ソースコードを読みやすくしながら、行折り返しのあるテキストエディターで表示できるようにするというMarkdown仕様の元々の目標から来ています。ドキュメントはあるエディターでは80列に折り返され、別のエディターでは120列になる場合があります。単一の改行はフォーマットに影響を与えるべきではありません。これによりMarkdownがエディター間で可搬性を持ちますが、意図的な改行を作成するには明示的な構文(末尾のスペースまたは空行)が必要です。

ソフト改行には末尾のスペースとバックスラッシュのどちらを使うべきですか?

どちらもCommonMarkパーサーで同じ結果を生成しますが、末尾のスペースはほとんどのエディターで表示されるため推奨されることが多いです。バックスラッシュも機能しますが、見づらいことがあります。GitHub Flavored Markdownは両方をサポートしています。ワークフローにとって明確な方を選択し、プロジェクト内で一貫性を保つようにしてください。

すべてのプラットフォームで改行の扱いは同じですか?

CommonMarkまたはGitHub Flavored Markdownを使用するほとんどの現代のプラットフォームは、改行を一貫して処理します。ただし、古いMarkdownパーサーや独自実装では動作が異なる場合があります。複数のプラットフォームで作業する場合は、改行をテストするか、プラットフォーム固有のドキュメントを確認してください。GitHubGitLabSlackはすべて標準の改行を正しく処理します。

Markdownの改行の代わりにHTML &lt;br&gt; タグを使用できますか?

はい。MarkdownはHTMLを直接記述できるため、<br> タグを直接使用できます。ただし、これによりソースの可搬性と可読性が低下します。HTMLアプローチは控えめに使用してください。通常、Markdownの末尾スペースまたはバックスラッシュ構文の方が明確です。HTMLに頻繁に頼る場合は、そのコンテンツにMarkdownが適切なフォーマットでない可能性があります。

コードブロックや引用ブロックのようなインデントされたコンテンツはどうなりますか?

改行ルールは引用ブロックや他のインデントされたコンテンツを含むすべての場所に適用されます。引用ブロック内の単一の改行は依然としてスペースとして扱われます。引用ブロックの段落を分けるには空行を、ソフト改行には末尾のスペースを使用してください。コードブロックは異なるルールを使用します。コードブロック(インデントまたはフェンス付き)の内部では、改行を含むすべてのコンテンツが文字通り保持されるため、改行は期待通りに機能します。

関連ツール