markdown共有ツール

Markdown共有ガイド / 画像付きMarkdownをZIPで共有

画像付きMarkdownをZIPで共有する方法

READMEや手順書がローカル画像を参照している場合、Markdownだけを渡すと画像が表示されません。Markdownと画像フォルダを同じZIPへ入れると、相対パスを保ったままmarkdown共有ツールで共有できます。

1. 正しいファイル構成を作る

Markdownは1ファイルに絞り、参照する画像を同じフォルダ配下へ置くと確実です。

project-guide/
├── README.md
└── images/
    ├── overview.png
    └── flow.webp

この例ではREADME.mdから見て、画像はimages/overview.pngimages/flow.webpにあります。ZIP内へ複数のMarkdownを入れず、共有したい本文を明確にしてください。

2. 相対パスで画像を書く

Markdown内の画像パスを、Markdownファイルから見た相対パスにします。

# プロジェクト概要

全体構成は次のとおりです。

![全体構成](images/overview.png)

## 処理フロー

![処理フロー](images/flow.webp)

macOSやWindows上の絶対パスは、受け手の環境や共有ページから参照できません。/Users/...C:\\Users\\...file://...は使わないでください。

3. Markdownと画像をZIPにする

  1. README.mdimagesフォルダを同じ親フォルダへ置きます。
  2. 親フォルダ全体、または中にあるMarkdownと画像フォルダを選んでZIP圧縮します。
  3. ZIPを開き、Markdownと画像が含まれていることを確認します。

対応画像はJPEG、PNG、WebP、GIFです。SVGは安全上の理由でアップロード対象外です。

4. ZIPをアップロードする

  1. アップロード画面を開きます。
  2. 作成したZIPをドロップするか、ファイルを選択から追加します。
  3. プレビューへ進み、すべての画像が本文内に表示されるか確認します。
  4. タイトル、表示期限、パスワードを確認します。
  5. 共有URLを作成を実行し、完成URLまたはQRコードを共有します。

アップロード画面では、Markdownが参照している画像とZIP内の画像をパスで照合します。見つからない画像があっても本文はプレビューできますが、欠落表示を確認してから公開してください。

5. 画像が表示されない場合

症状確認点
すべての画像が見つからないZIPに画像フォルダが含まれているか確認します
一部だけ見つからないファイル名、拡張子、大文字・小文字をMarkdownの記述と揃えます
ローカルでは出るが共有で出ない絶対パスやfile://ではなく相対パスへ変更します
別フォルダの画像が出ない../に頼らず、Markdown配下の画像フォルダへまとめます
SVGだけ追加されないPNGまたはWebPへ変換してからZIPへ入れます

6. 制限と安全上の注意

  • Markdownは1MB以内、1文書の合計は30MB以内です
  • 画像は最大30枚で、GIFを除きアップロード前にブラウザ内で処理されます
  • ZIP展開後のデータが大きすぎる場合は受け付けません
  • パスワード付きでもエンドツーエンド暗号化ではありません
  • 個人情報、秘密情報、認証情報、長期保管が必要な画像は共有しないでください

基本的なMarkdown共有から確認したい場合はMarkdownファイルをURLで共有する方法、現在の対応形式はヘルプ / FAQを参照してください。

画像付きMarkdownを共有する

最終確認日: / 確認: markdown共有ツール運営