ホームテクノロジーマークダウンの使用方法|有線

マークダウンの使用方法|有線


投稿しているかどうか の上 reddit不和、 または github、フォーマットを追加する方法は1つしかありません:Markdown。リンクを追加したり、テキストを太字にしたり、テキストをパラグラフに分割したりする場合は、このテキストベースのフォーマットシステムの基本を知る必要があります。

それは怖いですか?私を信じてください、そうではありません。 Markdownには、テキストを希望どおりにフォーマットするためのルールがいくつかあり、実際に使用するフォーマットのルールを学習するだけです。

単純なルールを見て、マークダウンが役立つ理由について話しましょう。そして、マークダウンをさらに進むために使用できるいくつかのリソースを見てみましょう。

マークダウンの基本

Markdownは、特定の文字を追加することにより、プレーンテキストにリッチフォーマットを適用する方法です。メッセージが短く、比較的単純なDiscordやRedditなどのプラットフォームでは、本当にいくつかの基本を学ぶ必要があります。

  • イタリック化 テキスト、それの前後にアスタリスクを入れてください、 *このように *
  • 大胆な テキスト、その前後に2つのアスタリスクを置きます**このように**
  • リンクを含めるには、リンクのテキストを正方形の括弧に挿入し、すぐに括弧内のURLが続きます。 [Like this](https://justinpot.com/)
  • 画像を追加するには、画像の説明を含む正方形のブラケットと、画像ファイルへのリンクを含む括弧で、感嘆符から始めます![Like this](https://justinpot.com/wp-content/uploads/2024/07/ima_02d2bc6.jpg)
  • 新しい段落を開始するには、Enterを2回押して、現在のテキストの行と次の行の間に明確な線があるようにします。

上記の5つのヒントは、RedditやDiscordのようなものに十分です。コードのように見えるものを入力しているにもかかわらず、投稿が公開されているときに、リンクと画像を備えたリッチテキストのフォーマットだけです。

ただし、マークダウンを使用してドキュメント全体を作成する場合は、ドキュメント固有のツールがいくつか必要になります。これが重要なものです:

  • ヘッダーを作成するには(この記事で上記の大規模なテキスト「The Basics of Markdown」など)、ポンドサインの後にスペースが続くテキストの行を開始します#。
  • ヘッダーを小さくするには、より多くのポンドサインを使用してください。##は、H2または###の場合はこのようなH3の場合などです。追加するポンドサインが多いほど、ヘッダーテキストは小さくなります。
  • 箇条書きのリストを作成するには、アスタリスクを使用してテキストの行を開始し、その後にスペースを開始します。あなたはあなたが望むだけあなたのリストに多くの弾丸の行を追加することができます。
  • リスト項目をインデントするには、アスタリスクの前にタブを置きます。さらにインデントするには、タブを追加するだけです。
  • 番号付きリストを作成するには、このような番号と期間を持つテキストの行を開始します。
  • 番号付きリスト項目をインデントするには、番号の前にタブを追加します。さらにインデントするには、タブを追加するだけです。
  • ドキュメントにブロック見積もりを追加するには、「than than」サインを使用してテキストのリンクを開始するだけです。

これは、マークダウンでドキュメントを書くために知っておくべきことのほとんどをカバーしています。このフォーマットがどのように見えるかについて混乱している場合、それは遊んで結果を見るのに役立ちます。これを行うのに最適なウェブサイトです MarkDownLivePreview.com。左パネルにはマークダウンが表示され、右側にはそれがどのように見えるかがわかります。そこで少しさまざまなことを試してみると、もっと快適に感じるでしょう。

なぜマークダウンを使用するのですか?

これはすべてあなたに尋ねるかもしれません:なぜサイトがテキストをフォーマットするためのわずかに難解な方法を学ぶことを強制するのですか?答えは、このシステムは、最初は少し混乱していても、慣れたら非常に簡単で明確であるということです。

ほとんどの人は、Microsoft WordやGoogleドキュメントなどのツールを使用して、コンピューターに書くことに慣れています。両方のワードプロセッサがあります。つまり、画面に印刷されたページを表すように構築されています。どちらも「あなたが見るものがあなたが得るもの」編集者、またはWysiWygエディターと呼ばれます。つまり、フォーマットは画面に直接表示されることを意味します。あなたがいくつかのテキストを太字にすると、あなたはそれを画面上で太字であると見ています。リンクを追加すると、リンクされたテキストが下線が引かれ、Webページのように青くなります。テキスト自体を見ること、太字が始まり、終了する場所、またはリンクの目的地が何であるかを知る方法はありません。

これは直感的に思えるかもしれませんし、公平を期すためには、それにはシンプルさがあります。しかし、そのシンプルさは、ユーザーが見ないコードによって可能になり、コードが舞台裏に保持されているという事実は、ある意味で混乱を招く可能性があります。リンクの最後にいくつかの単語を追加しようとした人、またはリンクの直後に、この曖昧さがイライラする可能性があることを知っています。最終的にリンクを長く作成するか、リンクされていないテキストを追加してリンクを追加するか、リンクを追加することになります。これは、すべてのフォーマットがどこから始まり、終了するかを明確に見ることができるため、マークダウンで書きながら起こりません。

Markdownファイルも将来の根拠です。すべてのテキストのフォーマット、リンク、およびドキュメント構造スキーマは、数十年で変更されておらず、1つの会社が所有していない形式であるプレーンテキストで記述されるため、50年でマークダウンファイルを見つけた人がそれを理解できるようになることを合理的に確信できます。 Microsoft Officeファイルについても同じことが言えません

関連記事

最も人気のある