Markdown showcase hero graphic

Markdown Showcase (MDXスタイル集)

見出し・テキスト・リスト・表・引用・コールアウト・埋め込みなど、代表的な装飾をまとめて確認できるサンプルページです。

この記事では、様々なマークダウン記法をテストして表示を確認します。

見出しサンプル(H2)

小見出し(H3)

さらに小見出し(H4)

より細かい見出し(H5)
最小見出し(H6)

基本的なテキスト装飾

本文は通常の段落です。

改行するとこのように自動的にレイアウトが調節されます。

太字・斜体・下線・取り消し線

太字のテキスト斜体のテキストです。

下線underline)、そして打ち消し線strikethrough)も使えます。

インラインコードブロック・リンク

インラインコードブロック inline code や、リンク(Example)も利用できます。

直接 https://example.com とアドレスを書いても https://example.com のように自動リンクが生成されます。

MDXでは、アドレスは <hello@example.com> などの記法は使えません。 通常の記法で [hello@example.com](mailto:hello@example.com) としてください。

引用・脚注・定義リスト

引用(Blockquote)

Markdown は文章構造を明確にしつつ、読みやすさを保てるシンプルな記法です。

— Harunosuke Markdown Guide

学びは一生続く旅である。

これは複数段落の引用の例です。本文とのコントラストや余白を確認できます。

Harunosuke

脚注

脚注は本文中から参照できます。たとえば「Markdown の脚注は便利1」のように書いておくと、ページ末尾に自動で注釈がまとめられます。

定義リスト

定義リストも利用できます:

用語A
意味や説明を書きます。複数行の場合は改行しながら記述できます。
用語B
別の用語を定義するときも同じ形式で追記します。
Note

Markdown 標準には定義リスト記法が含まれていないため、MDX では HTML を直接記述しています。

リスト表示

順序なしリスト(Unordered List)

  • 箇条書き 1
  • 箇条書き 2
  • 箇条書き 3

順序ありリスト(Ordered List)

  1. 手順 1
  2. 手順 2
  3. 手順 3

ul ネストリスト

  • レベル 1 項目 1
  • レベル 1 項目 2
    • レベル 2 項目 A
    • レベル 2 項目 B
      • レベル 3 項目 i
      • レベル 3 項目 ii
        • レベル 4 項目 α
        • レベル 4 項目 β
          • レベル 5 項目
          • レベル 5 項目
      • レベル 3 項目 iii
    • レベル 2 項目 C
  • レベル 1 項目 3
    • レベル 2 項目 D
      • レベル 3 項目 iv
      • レベル 3 項目 v

ol ネストリスト

  1. 第一章
  2. 第二章
    1. 第一節
    2. 第二節
      1. サブセクション 1
      2. サブセクション 2
        1. 詳細項目 A
        2. 詳細項目 B
          1. さらに詳細な項目
          2. 最も深い項目
    3. 第三節
  3. 第三章

タスクリスト(Task List)

  • 未完了のタスク
  • 完了済みのタスク
  • 途中のタスク

総入れ子

  1. レベル 1 項目 1
    • レベル 2 項目 1
    • レベル 2 項目 2
      • レベル 3 項目 i
        • レベル 4 項目 α
          1. レベル 5 項目
          2. レベル 5 項目
        • レベル 4 項目 β
      • レベル 3 項目 ii
  2. レベル 1 項目 2
    • レベル 2 項目 3
    • レベル 2 項目 4

水平線

上の段落と下の段落の間に水平線を挿入します。


水平線が正常に表示されるかテストしています。

コードブロックのテスト

JavaScript(言語のみ)

JavaScript
function greet(name) {
console.log(`Hello, ${name}!`);
}

greet("World");

Python(ファイル名付き)

hello.py
def greet(name):
print(f"Hello, {name}!")

if __name__ == "__main__":
greet("Python")

JavaScript(ファイル名のみ)

hello.js
function greet(name) {
console.log(`Hello, ${name}!`);
}

greet("World");

TypeScript(複雑な例)

types.ts
interface User {
id: number;
name: string;
email: string;
}

class UserService {
private users: User[] = [];

addUser(user: User): void {
this.users.push(user);
}

getUserById(id: number): User | undefined {
return this.users.find(user => user.id === id);
}
}

表はレスポンシブデザインによってモバイルでも読みやすくなっています。 フォントサイズも少し小さくして可読性を確保しています。

また、表のサイズによっては横スクロールが自動的に可能になります。

言語拡張子用途
JavaScript.jsWeb 開発
Python.pyデータサイエンス
Rust.rsシステム開発

幅の広い表(横スクロールテスト用)

ID名前メールアドレス電話番号住所職業会社名部署役職入社日給与備考
001田中太郎tanaka@example.com090-1234-5678東京都渋谷区1-2-3エンジニアABC株式会社開発部主任2020-04-01¥500,000React専門
002佐藤花子sato@example.com090-2345-6789大阪府大阪市北区4-5-6デザイナーXYZ株式会社デザイン部リーダー2019-06-15¥450,000UI/UX専門
003鈴木一郎suzuki@example.com090-3456-7890愛知県名古屋市中区7-8-9プロダクトマネージャーDEF株式会社企画部マネージャー2018-10-01¥600,000SaaS経験豊富
004高橋美咲takahashi@example.com090-4567-8901福岡県福岡市博多区10-11-12マーケティングGHI株式会社営業部課長2021-02-01¥550,000デジタルマーケティング
005伊藤健太ito@example.com090-5678-9012北海道札幌市中央区13-14-15データサイエンティストJKL株式会社データ部スペシャリスト2022-08-01¥650,000機械学習専門

テーブルアライメント例

左寄せ (Left)中央 (Center)右寄せ (Right)
applebananacherry
りんごバナナさくらんぼ

数値データの表

年度売上高(億円)営業利益(億円)純利益(億円)従業員数(人)売上高利益率(%)
20201,2001501005,00012.5
20211,3501801255,20013.3
20221,5002101505,50014.0
20231,6802501805,80014.9
20241,8502902106,10015.7

技術仕様の表

項目仕様対応ブラウザ説明
フレームワークNext.js 15.5.3Chrome, Firefox, Safari, EdgeReact ベースのフルスタックフレームワーク
スタイリングTailwind CSS 4.0全ての現代的ブラウザユーティリティファーストのCSSフレームワーク
アイコンReact Icons 5.5.0全ての現代的ブラウザSVGアイコンライブラリ
言語TypeScript 5.0TypeScript対応エディタ型安全な JavaScript
パッケージマネージャーnpmNode.js 環境JavaScript パッケージマネージャー

基本的なマークダウン記法まとめ

このテスト記事では以下の要素を確認しました:

  • 見出し(h1〜h6)
  • テキスト装飾(太字、斜体、取り消し線、リンク、インラインコード)
  • リスト(順序あり・なし)
  • 引用ブロック
  • 水平線
  • コードブロック(言語のみ・ファイル名付き)

すべてが正常に表示されていれば、マークダウン処理は正常に動作しています!


ここからはコンポーネント挿入による装飾などをテストします。

コールアウト(Callouts)

Note

これは注意書き/メモのコールアウトです。背景色とボーダーで本文と区別します。

Tips

補足情報やヒントを強調するときに使います。リストやコードなど、本文から拾い残しがちな細部を支援します。


コードブロック(Code Blocks)

TypeScript
// TypeScript example
type User = { id: string; name: string };

function greet(user: User) {
return `Hello, ${user.name}!`;
}

console.log(greet({ id: "u1", name: "Harunosuke" }));
Shell
# Shell example
rg -n "pattern" src

画像(Image)

画像の表示

サンプル画像
Unsplashからの外部画像の表示例(フルブリード)

埋め込み(Embeds)

YouTube

Twitter(シンプルブロック引用)

これは SNS 埋め込みの簡易例です。公式ウィジェットスクリプトが読み込まれていない環境では 通常の引用として表示されますが、リンクを辿れば投稿にアクセスできます。

https://twitter.com/jack/status/20


数式(MathJax)

インライン: は有名な恒等式です。

ディスプレイ:

Note

数式は MathJax CDN により描画されます。動的な再描画は不要なため、このページでは自動で整形されます。

様々な数式表示:

これは他の記事で書かれた定理のコンポーネントによる再利用です。

リンクプレビュー(Link Preview)

代替 URL 例

Footnotes

  1. 脚注の本文です。Markdown/MDX ではこのようにページ下部に詳細をまとめて書けます。HTML を混在させたり、リンクや画像を含めることも可能です。