Markdownガイド

Markdownは、少数の書式ルールを備えたプレーンテキストです。このガイドはエディタと併せて参照してください。ドキュメント自体は、このガイドとは別に保存してください。

Markdownエディターを開く →

日常のMarkdown

見出しと強調

# 文書タイトル

## セクション

**太字**、*斜体*、~~削除~~。

リストとチェックリスト

- 最初の項目
- 2番目の項目

1. 最初のステップ
2. 2番目のステップ

- [x] 完了
- [ ] 次のタスク

表

| 機能 | ステータス |
| --- | --- |
| ライブプレビュー | 準備完了 |
| ローカルリカバリ | 準備完了 |

リンク、画像、コード

[例](https://example.com)

![代替テキスト](https://example.com/image.png)

`inline code` を使用してください。

```js
const message = "Hello";
```

数式をインラインで表示する

エリアは$A = \pi r^2$です。

$$
E = mc^2
$$

Mermaidフローチャート

```mermaid
flowchart LR
  A[入力] --> B[プレビュー]
  B --> C[ファイルを保存]
```

ドキュメントを開いて保存する

ファイル → ファイルを開くを選択するか、.md、.markdown、または.txtファイルをワークスペースにドラッグ&ドロップしてください。各ファイルはそれぞれ別のタブで開き、現在のドキュメントは上書きされません。新規ドキュメントは空の状態で開始されます。最大2MiBまでのUTF-8ファイルと、最大20個のタブがサポートされています。

「保存」機能は、ブラウザが対応していて権限が付与されている場合、選択したローカルファイルに書き込みます。そうでない場合は、Markdown形式のダウンロードを開始します。ダウンロード要求は、ファイルがディスクに保存されたことを確認するものではありません。「名前を付けて保存」では、新しい保存先を選択できます。ページを再読み込みした後、以前に開いたファイルを再度開くと、直接保存機能が再接続されます。

ブラウザの復元機能はファイルのバックアップではありません

復元機能は、このブラウザで開いているドキュメントとタブの状態を保存します。すべてのインターフェース言語で同じワークスペースを共有します。タブのドットは、ブラウザの復元状態ではなく、前回のファイル保存またはMarkdownダウンロード要求以降の変更を追跡します。

プライベートブラウジング、ストレージの削除、サイトデータの消去を行うと、復元コピーが削除される場合があります。重要なドキュメントはファイルに保存してください。変更したタブを閉じると確認を求められます。すべてのドキュメントを閉じると、確認後に復元コピーが削除されます。別のブラウザタブで保存されていない変更は自動的にマージされません。

快適なワークスペース

2行目のコントロールを使用して、分割表示、ソースのみ表示、プレビューのみ表示を切り替えます。分割表示では、プレビューはエディターの意図的なスクロールにのみ追従します。プレビューをスクロールしたり、ソースを入力したりしても、もう一方のペインは移動しません。コンテンツが変更されると、対応するMarkdownブロックによって読み位置が保持されます。大規模な書き換えや削除されたセクションでは、近くにある残存ブロックが使用されます。完全に独立したペインにするには、フォローをオフにしてください。

アウトラインボタンをクリックすると、サイドバーを固定せずにドキュメントの見出しを開くことができます。設定メニューには、システム、ライト、ダークのテーマ、14~24ピクセルのエディターテキストスライダー、システム等幅フォントまたはサンセリフ、行番号、レンダリングの切り替え機能があります。既存のテキストサイズ設定は保持され、新しいワークスペースのデフォルトは16ピクセルです。例ボタンをクリックすると、コピーと挿入が可能な検索可能なスニペットが表示されます。表ボタンをクリックすると、列と行を選択するピッカーが開きます。選択した行数にはヘッダーが含まれます。Ctrl/Command + Fでソース内を検索できます。Tabキーでエディターを終了し、矢印キーで書式設定ボタン間を移動できます。

UTF-16コード単位が25万個以上、または改行数が1万回以上の文書の場合、入力時の応答性を維持するため、自動プレビューは一時停止されます。意図的に更新する場合は、「プレビューを更新」を使用してください。編集およびMarkdownの保存は引き続き可能です。

方程式

インライン数式には$...$または\(...\)を使います。独立した数式は、$$を前後の別々の行に置くか、\[と\]を別々の行に置いて囲みます。バッククォート内のコードは数式として扱いません。通貨記号が数式と誤解される場合は、\$のようにエスケープしてください。

ローカルのKaTeXレンダラーは、LaTeXの一部の形式のみをサポートし、完全な.tex文書はサポートしていません。出力にはネイティブのMathMLが使用されます。レンダリングできる式は100個まで、式1つあたりの文字数は4,000文字までという制限があります。サポートされていないコマンドや安全でないコマンドは、スクリプトを実行したり外部リソースを読み込んだりする代わりに、元のソースコードを保持します。

Mermaid図

mermaidと指定したコードフェンスは、図の描画を有効にするとローカルで表示されます。図はクラウドサービスに送信されません。描画処理は不透明なオリジンのサンドボックス内で実行され、ネットワークやストレージへのアクセスは遮断されます。

レンダリング可能な図は、それぞれ12,000文字までで最大24個までです。200エッジの制限とレンダリング期限により、さらに保護されます。図内の設定ディレクティブとYAML設定フロントマターは拒否されます。無効な図やサポートされていない図は、ソースとして読み取ることができます。

執筆作業を別のアプリに移す

Markdownのコピーはソースをコピーします。HTMLのコピーはポータブルなHTMLマークアップをコピーし、数式と図はソースとして保持します。書式付きテキストのコピーはHTMLとプレーンテキストをコピーし、リッチクリップボードコンテンツを受け入れるアプリに見出し、強調表示、リスト、表を貼り付けるのに適しています。正確な書式設定は受信側のアプリによって異なります。図と数式はクリップボードとの互換性のためにソースとして保持されます。

HTMLエクスポートは、レンダリングが成功した場合、ローカルのMathML数式とサニタイズされた図表画像を含むスタンドアロン文書を生成します。IT Drawerスクリプトは不要です。印刷/PDFとして保存はブラウザの印刷ダイアログを使用します。PDFの保存はオペレーティングシステムに依存します。外部Markdown画像は、その文書に対して明示的に許可しない限りブロックされたままです。

オフラインでの使用とインストール

ファイル → オフラインでインストールを選択し、接続中にオフラインを有効にするを選択します。これにより、エディタシェルが対応するすべてのインターフェース言語とレンダリングライブラリに対応します。オフラインファイルはドキュメントの復元とは別に保存されます。ブラウザ経由でのインストール、またはホーム画面への追加は任意です。

オフラインでの使用準備が完了したことをメニューに表示されるまで、接続を切断しないでください。Markdownワークスペースはオフラインでサポートされていますが、リモート画像、このガイド、およびその他のIT Drawerツールは含まれません。ブラウザのストレージは永続的ではありません。更新はエディタウィンドウが閉じるまで行われ、アクティブなドキュメントは再読み込みされません。

オフラインキャッシュを削除すると、Markdownワーカーのみが登録解除され、アプリケーションキャッシュのみが削除されます。復元ドキュメントは保持されます。削除後は、すべてのエディターウィンドウを閉じてください。ドキュメントも完全に消去するには、エディターでドキュメントを閉じるか、サイトのブラウザデータをクリアしてください。

READMEファイル、メモ、プロジェクトドキュメント用のMarkdown

Markdownを使えば、ページレイアウトに時間をかけずに、プレーンテキストで構造化されたコンテンツを作成できます。見出しには#、リストには-、チェックリストには- [ ]、表にはパイプ記号(|)を使用します。コードブロックは、手順書やREADMEの例に便利です。数式や図は、技術的な説明を分かりやすくするのに役立ちます。ライブプレビューでは、ソースコードがレンダリングされたときにどのように表示されるかを確認できます。

執筆には、Markdownエディターを開いて、プレビューを見ながら複数のドキュメントを並べて編集してください。重要なファイルを作成する場合は、実際の.mdファイルとして保存してください。ブラウザの復元機能はワークスペースを復元するのに役立ちますが、バックアップではないため、サイトデータが削除されると失われる可能性があります。

Markdownエディターを開く →