実際の文書でビューアを選ぶ
Markdownビューアを選ぶときは、普段使う構文の表示、ファイルの扱い、編集後の保存を確認します。この記事はMD Openerの運営者による確認手順です。他製品を独立に評価したランキングや速度比較ではありません。
Markdownビューアと、最終的な公開先の両方で同じサンプルを試してください。Markdown対応をうたうツールでも、拡張構文やリンクの解決方法は異なります。
再現できる表示チェック
# ビューアの確認
## 表
| 項目 | 状態 |
| --- | --- |
| サンプル | 確認待ち |
- [x] 完了した項目
- [ ] 未完了の項目
~~古い説明~~ 新しい説明。
```js
const greeting = "hello";
```
[参照先](https://example.com/)
表が2列になり、チェック状態が区別でき、取り消し線とコードブロックが表示されることを確認します。コードフェンスに言語名を書くだけでは、色付きの構文強調まで保証されません。必要なら、その機能を別に確認してください。
見出しやコードブロックは一般的なMarkdownでも使えます。表、タスクリスト、取り消し線などはGFMでよく使われる拡張です。GitHubのサービス全体にはリポジトリの情報なども加わるため、単体ビューアと完全に同じ表示になるとは限りません。
編集と保存を確認する
- 機密情報を含まない
.mdファイルを読み込みます。 - ソースとプレビューを比較し、1文だけ変更します。
- Markdownを書き出します。
- 書き出したコピーを開き直し、変更が保存されたか確認します。
- PDFやWordが必要なら、表、画像、長いコード行を含むサンプルで、その形式の出力も確認します。
プレビューは元のファイルを自動で上書きせず、共同編集用の共有文書も作りません。ページを離れる前にコピーを保存してください。
ボタン名だけでプライバシーを判断しない
「アップロード」というボタンでも、ローカルのファイル選択だけを行う場合があります。表示名だけではサーバー送信の有無は分かりません。MD OpenerはMarkdownをブラウザ内で処理しますが、文書に含まれる外部画像URLへのアクセスは発生し得ます。ページの配信や任意のサービスについてはプライバシーポリシーを確認してください。
通信を確認する場合は、実データではなく無害なサンプルを使います。ブラウザ拡張機能、共有端末、ダウンロード先も考慮し、外部接続を禁止する運用では承認済みのオフライン環境を使ってください。
読者の端末でも確認する
スマートフォンではファイル選択を使い、横に長い表とコードを確認します。相対パスの画像には元のファイル構成が必要です。表示されない画像があるだけで、構文の解析が壊れているとは限りません。
機能の数や「最高」という表現ではなく、自分の文書で確認できた結果を基準に選びましょう。