洛谷におけるMarkdownの使い方

洛谷におけるMarkdownの使い方

編集者:Jerrycyx(ブログ、洛谷、CSDN)

洛谷のコラムを参照してください。

  • 洛谷のブログは他の場所とは異なるレンダリングメカニズムを使用しているため、表示が正しくない場合があります。このリンクで確認してください:https://www.luogu.com.cn/paste/wu019n2x

2024.7.28 更新: 「引用」の使用法を更新し、一部の表示エラーを修正しました。新しいロクグエディタに合わせてリンクとその他の内容も更新しました。

はじめに

より豊かな表示を求めるなら、MarkdownやKaTeXを使ってください。

これは洛谷のテキストエディタに表示される一文です。あなたが疑問に思うかもしれません:KaTeX Markdownとは何ですか?なぜ洛谷のテキストエディタはこんなに奇妙な見た目をしているのでしょうか? この記事では、これらの質問に答え、短時間でMarkdownを精通する方法を紹介します。

Markdownとは何か?

Markdownは軽量マークアップ言語です。

どういうことかというと、あなたが一段の文章(【ソースコード】)を入力すると、洛谷が自動的にレンダリングして表示します。

例えば、_Haha_(下線で囲まれた)を入力すると、洛谷はそれを Haha (斜体)として表示します。

洛谷のテキストエディタでは Markdown*Palettes(GitHubアドレス:https://github.com/luogu-dev/markdown-palettes)を使用しています。これはMarkdownの一種です。

また、「ソースコード」という言葉に驚かないでください。Markdownは非常に簡単で、使用する記号は十個未満です。

では、実際に学んでいきましょう!

Markdownエディタ

以下は洛谷のクラウドクリップボードのMarkdownエディタを例にします:

このエディタは三つの部分に分かれています:

  • ツールバー

  • エディタ領域(左側)

  • 予習領域(右側)

  • ツールバーには洛谷Markdownでよく使う記号が含まれています(すべてではありません)。Markdownに精通すれば、基本的にツールバーは使わなくなります。

  • あなたはエディタ領域でソースコードを書くことができます

  • 予習領域は、あなたのソースコードをレンダリングした結果を表示するものであり、公開後に表示される内容です。予習領域は直接編集できません

Markdown構文

タイトル

Markdownには6段階のタイトルがあります。記号は # です。文字の前にいくつかの # と空欄を追加することで、この文字列をタイトルとして表示できます。

タイトルにいくつ # があるかによって、何段階のタイトルかが決まります。1段階のタイトルが最大で、6段階のタイトルが最小です。

ツールバーでの対応は H1H2H3...です。

H1 は1段階のタイトル、H2 は2段階のタイトル、以此類推。

例:

# 1段階のタイトル

## 2段階のタイトル

### 3段階のタイトル

#### 4段階のタイトル

##### 5段階のタイトル

###### 6段階のタイトル

これは次のようになります:

1段階のタイトル

2段階のタイトル

3段階のタイトル

4段階のタイトル

5段階のタイトル
6段階のタイトル

注:上のレンダリング結果の左側には縦線があり、フォントが変更されているのは、全体の文章のレイアウトに影響を与えないようにするために「引用」の方法を使用したためです(後ほど説明します)。実際のレンダリング効果では縦線やフォントの変更はありません。

いくつかの詳細:

  • 1段階および2段階のタイトルには自動的な区切り線が付いています(このブログでは表示されていないのは、ブログのレンダリングメカニズムが洛谷の他の場所と異なるためです)。
  • 4段階のタイトルのフォントサイズは本文より小さくなっているため、通常は4段階以下のタイトルは使用しません。
  • 入力時に # の後には必ず空欄が必要です。

太字

Markdownの太字は左右にそれぞれ2つの * で表されます。

ツールバーでは太字は符号 B で表され、次のように表示されます:

例えば:

**太字の文章**

これは次のようになります:

太字の文章

  • ヒント:太字にしたい文章を選択し、ツールバーの B をクリックすれば、その文章を太字にできます。
  1. 選択
  1. B をクリック
  1. 太字成功

斜体

Markdownの 斜体 は左右にそれぞれ1つの _ または左右にそれぞれ1つの * で表されます。

ツールバーでは斜体は符号 I で表され、次のように表示されます:

例えば:

_斜体の文章_

*斜体の文章*

これは次のようになります:

斜体の文章

斜体の文章

  • ヒント:斜体にしたい文章を選択し、ツールバーの I をクリックすれば、その文章を斜体にできます。
  • 注意:斜体のソースコードは他の文章と空欄で区切る必要があります。

ハ_ハハハ_ハ は正常にレンダリングされません:ハ_ハハハ_ハ

一方で ハ _ハハハ_ ハ は正常にレンダリングされます:ハ ハハハ

削除線

Markdownの削除線は左右にそれぞれ2つの ~ で表されます。

ツールバーでは削除線は符号 S で表され、次のように表示されます:

例えば:

~~削除の文章~~

これは次のようになります:

削除の文章

  • ヒント:削除線を付けたい文章を選択し、ツールバーの S をクリックすれば、その文章に削除線を追加できます。

区切り線

洛谷のMarkdownにおける区切り線の表示効果は次の通りです:

区切り線はツールバーの記号 に対応しています、つまり:

クリック すると自動的に生成されます:


------------


(まず2行空けて、その後に12個の - を入れ、最後にもう2行空けます)

手動で入力する方法はいくつかあります:

---
- - -
***
* * *
___
_ _ _

レンダリングすると:

(あら、ブログではちょっと分かりにくいですね?)

注:

  • -_* の数はいくらでも構いません(少なくとも3つ以上必要です)

無順序リスト&順序リスト

無順序リストと順序リストはツールバーに次の記号があります:

(左にある点は無順序リスト、左にある数字は順序リストです)

ここではツールバーをおすすめしないので、手書きの方が良いです。ツールバーのリストには大きなバグがあるからです。

順序リストはとても簡単で、「数字+点」の形式で直接リストを作ります:

1. 第一条
2. 第二条
3. 第三条

  1. 第一条
  2. 第二条
  3. 第三条

間に空白行を入れても(圧迫感を減らすために):

1. 第一条

2. 第二条

3. 第三条

  1. 第一条
  2. 第二条
  3. 第三条

無順序リストも同様です:

+ こんにちは

- こんにちは

* こんにちは


  • こんにちは

  • こんにちは

  • こんにちは

  • +-* はすべて無順序リストとして正しく表示されますが、ここでは**+を推奨**します。-* は他の用途を持っているため、混用すると問題が起こる可能性があります。

  • 無順序リストの +-* と順序リストの「数字+点」の後には必ず空欄が必要で、そうでなければ正常に表示されません。

画像

画像はツールバーにこのような形で表示されます:

ここには2つのポイントがあります:

  • 画像のURLは画像のネットワークアドレスを指します:Markdownはインターネット上にある画像のみ読み込むことができ、パソコン内の画像は読み込めません(実はすべてのネットワークで画像が必要な場所は同じです)。そのため、画像ホスティングを通じてパソコン内の画像をインターネット上にアップロードし、その画像のネットワークアドレス(つまりURL)をMarkdownに伝えなければなりません。以下はいくつかの画像ホスティングサイトです:
  • 洛谷画像ホスティング:https://www.luogu.com.cn/image
  • 過去画像ホスティング:https://imgse.com/
  • SM.MS画像ホスティング:https://sm.ms/
  • 画像の説明は一般的には表示されませんが、元の画像が破損または表示できない場合、画像の説明が表示されます

画像のMarkdown形式は次の通りです:

![画像の説明(空でも可)](画像のURL)

例えば:

![Luogu-Logo](https://cdn.luogu.com.cn/fe/logo.png)

画像が表示できない場合、次のようになります:

リンク

リンクはツールバーにこのような形で表示されます:

  • リンクのURL:リンクをクリックした後に移動するウェブサイトのアドレス
  • リンクのタイトル:リンクに表示される内容

リンクの形式は次の通りです:

[リンクのタイトル](リンクのURL)

例えば:

[洛谷](https://www.luogu.com.cn/)

洛谷

リンクタイトルがない別のリンク表示方法もあります。直接リンクのURLを表示します:

<リンクのURL>

例えば:

<https://www.luogu.com.cn/>

https://www.luogu.com.cn/

コードブロック

コードブロックは2種類あります:インラインコードブロックとブロックコードブロック

インラインコードブロックはこのようなものです:コードブロック

方法は簡単です:両端に ` を追加するだけです。

`コードブロック`

コードブロック

(ブロック)コードブロックのツールバー記号は:

ブロックコードブロックの形式は次の通りです:

コードの内容

例えば:

#include
using namespace std;

int main()
{
int a,b;
scanf("%d%d",&a,&b);
printf("%d\n", a+b);
return 0;
}

  • コード言語はcpp、c、pythonなどの言語です(空でも構いません)

表の形式はやや複雑で、ツールバーのボタンを使うのが便利です。

| カラム1 | カラム2 | カラム3 | カラム4 |
| -----------: | -----------: | -----------: | -----------: |
| 内容1,1 | 内容1,2 | 内容1,3 | 内容1,4 |
| 内容2,1 | 内容2,2 | 内容2,3 | 内容2,4 |

カラム1 カラム2 カラム3 カラム4
内容1,1 内容1,2 内容1,3 内容1,4
内容2,1 内容2,2 内容2,3 内容2,4

(新規)引用

ある文章を引用したい場合は、文章の前に > を追加します。

> 洛谷 Markdown - 从入门到精通
>
> ——作者:Jerrycyx

これは次のようになります:

洛谷 Markdown - 从入门到精通

——作者:Jerrycyx

注意事項:

  • 各段落の前に > を打つ必要があります
  • 空行でも > を打つ必要があります。そうしないと、レンダリングされた引用内容が断続的になり、次のように表示されます:

123

321

\(\KaTeX\) 内部埋め込み

洛谷の問題解説、翻訳、問題文中では、数字や式はすべて \(\KaTeX\) で記述しなければなりません。方法は次の通りです:

$1+1=2$ は \(1+1=2\) にレンダリングされます

$$1+1=2$$ は(単独行で中央揃え)にレンダリングされます

[1+1=2 ]\(\KaTeX\) は別の言語であり、今度別の記事で紹介します。まずはこれを見てください:

  • Supported Functions · KaTeX

ツールバーの他の記号

左から右へ順に:

  • プレビュー非表示:プレビューを非表示にして、ソースコードエディターのみ表示します。
  • フルスクリーン:Markdownエディタをフルスクリーン表示します。
  • スクロール同期を無効化:スクロール同期とは、左側/右側のコンテンツをスクロールすると、もう片方のコンテンツも一緒にスクロールする機能です。このボタンをクリックするとこの機能を無効化します。
  • 情報:クリックすると、洛谷Markdownに関する情報とGitHubプロジェクトのアドレスが表示されます。
  • 自動整形:あまり役に立ちません。

洛谷Markdownと他のMarkdownの違い

  • 洛谷Markdownにおいて、最終的に改行したい場合は、ソースコード内で2回改行する必要があります(つまり、1行空ける)。
  • 洛谷MarkdownはHTMLの埋め込みをサポートしていません。
  • 洛谷Markdownは内蔵の \(\KaTeX\) を使用しており、他の多くのシステムは \(\LaTeX\) を使用しています。
  • 洛谷Markdownは ==text== のハイライト構文をサポートしていません。

(他にもたくさんあるかもしれませんが、面倒なので見つけていません)

最後に

お気に入りボタンを押してください QwQ!

5月31日 21:15 投稿