Skip to main content

当Wikiでの Markdown(CommonMark)の使い方

注:この文書は英語の原文からの自動翻訳です。

このページは、コンテンツがCommonMark Markdownで記述されている当ウィキでページをフォーマットするための短い「チートシート」です。

基本ルール

  • シンプルで短い文章で書く。
  • ページを斜め読みしやすくする:見出し + リスト + 表。
  • 1つのセクション = 1つのアイデア。「文字の壁」を避ける。

見出し

構造には ## / ### / #### を使用します。

## セクション
### サブセクション
#### サブサブセクション

太字、斜体、インラインコード

**太字**
*斜体*
`コード/フィールド/アドレス`

リンク

[リンクテキスト](https://example.com)

「生の」リンクを表示する必要がある場合(まれ):

`https://example.com`

リスト

箇条書きリスト:

- アイテム 1
- アイテム 2
  - サブアイテム

番号付きリスト:

1. ステップ 1
2. ステップ 2
3. ステップ 3

引用 / メモ

> これは重要なメモです。
> 2行になることもあります。

最小テンプレート:

| フィールド | 値 |
|---|---|
| 名前 | [ ] |
| ステータス | [ ] |

ヒント:

  • 区切り行 |---|---| は必須です。
  • 表のセルには **太字**、リンク、コード を含めることができます。

コードと「生の」テキストブロック

コードブロック:

\```text
行 1
行 2
\```

特定の言語(JSONなど)である場合は、それを指定できます:

\```json
{ "key": "value" }
\```

画像

直接の画像URLがある場合:

![説明](https://example.com/image.png)

ファイルがウィキにアップロードされている場合は、アップロード時にウィキが提供するリンク/埋め込みを使用します。

改行と段落

  • 新しい段落は、段落間の空白行です。
  • 段落内で改行する必要がある場合は、行末に2つのスペースを追加します:
1行目。  
2行目。

埋め込みHTML(注意して使用)

折りたたみ可能な「詳細」ブロック

「最初の画面」が過負荷になるのを避けるために、長い詳細/証拠に使用します。

<details>
<summary><b>詳細</b></summary>

ここにテキスト、リスト、表を配置できます。

</details>

ページ内のアンカーとクイックリンク

アンカー:

<a id="ai-thesis-fit"></a>

アンカーへのリンク:

[AIテーゼの適合性へジャンプ](#ai-thesis-fit)

テンプレートのプレースホルダー

テンプレートでは以下を使用します:

  • [ ] — 「記入する」
  • / — 「— / 該当なし」(意味がある場合)
  • YYYY‑MM‑DD — 日付形式
  • Tier‑1/2/3 — ソース層(証拠/コンテキスト/ノイズ)

よくある間違い

  • 情報ボックスと説明を混ぜる:情報ボックスは短い事実のみです。説明はページの本文に記述します。
  • ソースが存在するはずの場所にソースなしで書く
  • 「最初の画面」を過負荷にする:長い詳細は <details> の中に配置する方が良いです。
  • 「金融用語」を使用する(売買/保有の推奨、予測) — これは禁止されています。事実/リスク/検証すべきことを記述します。

公開前のミニチェックリスト

  • 「それが何であるか」を説明する1〜2行がありますか?
  • 一次ソースへのリンクがありますか?
  • 空の「不明確な」表のフィールドがありますか(各フィールドは値または —/— のいずれかである必要があります)?
  • Last verified は記入されていますか?