MDファイルはテキスト文書
.md ファイルは通常、見出しやリストなどの記号を含むMarkdown文書です。テキストエディタでも読めます。ビューアはその記号を整形し、表や長い文書を読みやすく表示します。
Markdownビューアでは、アカウント作成やエディタのインストールなしに .md と .markdown ファイルを読み込めます。ここでは表示、編集後の保存、画像が欠ける場合の確認方法を説明します。
小さなサンプルで表示を確認する
# プロジェクトの状況
## レビューチェック
- [x] 下書きを準備
- [ ] 参照先を確認
| 分野 | 担当 |
| --- | --- |
| 本文 | 編集者 |
| 確認 | レビュー担当 |
- ビューアを開き、このサンプルを貼り付けるか、ファイル選択で文書を読み込みます。
- タイトルと節の見出しの大きさを確認します。
- チェック状態が異なり、表が2列になっていることを確認します。
- ソースとプレビューを比較し、記号と表示の対応を見ます。
- 編集したらMarkdownを書き出し、そのコピーを開き直して変更を確認します。
サンプルは架空の内容です。チェック済みの印は文書に書かれた状態であり、作業完了をシステムが検証した記録ではありません。元のファイルは自動で上書きされません。
端末ごとの開き方
WindowsやmacOSでは、保存した添付ファイルをブラウザのファイル選択から開きます。デスクトップではビューアの領域へのドラッグにも対応します。拡張子が非表示の場合は、notes.md.txt などの実際のファイル名を確認してください。
スマートフォンでは、添付ファイルをFilesやダウンロードフォルダに保存してから選択します。読むだけならプレビューモードが便利です。幅の広い表は横方向にスクロールし、長いコード行も確認します。
拡張子を .md から .html に変えてもHTMLには変換されません。Word文書を .md に改名しても同様です。元のアプリからMarkdownまたはプレーンテキストとして書き出してください。
表示がおかしいとき
| 症状 | 確認箇所 |
|---|---|
| 表がパイプ記号のまま | 区切り行とGFM対応 |
| 文書の大半がコードになる | 閉じていないコードフェンス |
| 画像がない | 相対パス、添付漏れ、URLの権限 |
| リポジトリでしかリンクが動かない | 元のフォルダ構成やアクセス権 |
| 文字化けする | 元ファイルの文字コード |
Markdownを1つ読み込んでも、隣の画像フォルダは読み込まれません。必要な素材を送信者に確認するか、本来のリポジトリで読んでください。
機密情報と書き出し
Markdown本文はブラウザ内で処理しますが、外部画像のURLにはアクセスが発生し得ます。「アップロード」というボタン名だけで送信の有無を判断せず、実際の処理とプライバシーポリシーを確認してください。ブラウザ拡張機能、共有端末、保存先にも注意し、所属組織のルールに従います。
必要ならHTML、PDF、Wordを書き出せます。画像、表、改ページを出力ファイルでも確認し、後の修正用に原本を保存してください。
Windows・Mac・メール添付で確認すること
Windowsでは、ファイル名を変える前にエクスプローラーで拡張子を表示します。notes.md.txt の最後の拡張子は .txt です。中身がMarkdownのプレーンテキストであることを確認してから必要な変更を行います。ブラウザでの読み込みは、Windowsの既定のアプリを変更しません。
macOSでは、Finderの「情報を見る」で非表示の拡張子を確認します。TextEditなどで作ったリッチテキストにはRTFの書式命令が含まれる場合があります。元のアプリからプレーンテキストとして書き出し、文字と文字コードを確認してください。.rtf を .md に改名しても変換にはなりません。確認が終わるまでは原本を残します。
メールの添付ファイルは、リンクを開く前に送信元を確認し、まず原本を保存します。メールアプリが本文内プレビューしか表示しない場合は、添付のダウンロードや保存を使います。README.md だけでは送信者の画像フォルダは含まれません。必要な画像や一式のアーカイブを、承認された方法で依頼してください。
原本を残して編集結果を確認する
書き出すソースには project-notes-reviewed.md のように区別できる名前を付けます。そのコピーを再度読み込み、変更した文が含まれることを原本と比較します。ダウンロード時にファイル名へ番号が付いた場合は、古い同名ファイルを開いていないか確認します。
タブを閉じたりページを更新したりすると、メモリ上の編集が失われることがあります。離れる前にMarkdownのコピーを保存してください。PDFは読むためには便利ですが、後で改訂するなら編集可能なMarkdownも残しておく必要があります。