# シンプルMDビューア＆エディター 操作マニュアル

バージョン: v2.4.0

## 直近の主な追加機能

- 上部の操作欄を折りたためるようになりました。起動時は小バーだけを表示します。
- `編集のみ` 画面を追加しました。
- `Home` は行頭移動、`Ctrl + Home` は文書先頭移動になりました。
- TeX形式の数式を表示できるようになりました。
- `Ctrl + E` で、読む画面と編集＋ビューア画面を切り替えられます。
- 編集中のヒント欄に、分数、べき乗、根号、2次方程式の解の公式を追加しました。
- 教材用の空欄記法 `[brank]` を追加しました。
- 画像表示と画像サイズ指定に対応しました。

## MarkdownとHTMLの関係

Markdownは、HTMLを直接書かなくても、見出し、箇条書き、表、強調などを簡単に表せる書き方です。

たとえば、HTMLでは見出しを `<h1>見出し</h1>` のように書きますが、Markdownでは `# 見出し` と書けます。
箇条書きも、HTMLでは `<ul>` や `<li>` を使いますが、Markdownでは行の先頭に `-` を付けるだけです。

つまりMarkdownは、文章を書く人が内容に集中しやすく、あとからHTMLのような読みやすい表示に変換できる、軽い文書形式です。
学校で配るメモ、授業準備、AI回答の整理、簡単な資料づくりに向いています。
## このアプリでできること

シンプルMDビューア＆エディターは、Markdownファイルを読み込んでHTMLとして解釈し、CSSで見やすく整えて表示・編集・印刷できるS-JIS対応ソフトです。
学校で使いやすいように、Shift-JIS / CRLF の文書を標準おすすめにしています。

主に扱うファイルは次の3種類です。

- .md
- .txt
- .csv

## 基本的な利用法

普段は `読む` 画面で文書を読みます。
内容を直したいときは、`編集＋ビューア`、`編集のみ`、`編集＋ヒント` に切り替えます。
`Ctrl + E` でも、読む画面と編集＋ビューア画面を切り替えられます。
集中して文章だけ直したいときは、`編集のみ` または `Ctrl + Shift + E` を使います。

起動時は、画面上部の細いバーだけを表示します。
文字コード、改行、フォルダー、開く、保存などの操作欄を使うときは、右上の `操作を表示` を押します。
もう一度押すと、操作欄を折りたためます。

編集画面では、左のエディターにカーソルを置いてマウスホイールを動かすと、左のエディターだけがスクロールします。
右側のビューアやヒント欄をクリックして、エディターからフォーカスを外してからマウスホイールを動かすと、左右が同時にスクロールします。
長い文書を編集するときは、必要に応じて左だけ動かすか、左右をそろえて動かすかを使い分けられます。

## 起動する

`simple-md-viewer-editor.exe` を開くと、サンプル文書が表示されます。

.md ファイルを関連付けしている場合は、.md ファイルをダブルクリックして開けます。

ファイルをアプリ画面へドラッグ＆ドロップして開くこともできます。

## 現在のフォルダー

参照 を押すと、現在のフォルダーを選べます。
ここで選んだフォルダーは、次に 開く を押したときの出発点になります。

## ファイルを開く

1. 画面右上の `開く` を押します。
2. 開きたい .md / .txt / .csv ファイルを選びます。
3. ファイルがビューアで表示されます。

文字コードと改行コードは自動判別します。
開く は、現在のフォルダーを出発点にしてファイル選択を開きます。

## 画面の切り替え

画面には4つのモードがあります。

- `読む`
  - 文書を読むための画面です。
  - 普段はこの画面を使います。

- `編集＋ビューア`
  - 左で編集し、右でプレビューを確認します。
  - Markdownの見え方を確認しながら直せます。
  - 右側のビューアをダブルクリックすると、読む画面に戻ります。

- `編集のみ`
  - 画面全体を使って本文を編集します。
  - 長い文書を直すときや、プレビューを見ずに文章を整えたいときに使います。

- `編集＋ヒント`
  - 左で編集し、右でMarkdownの基本ルールを確認します。
  - Markdownに慣れていない人向けです。

## 新しい文書を作る

`新規` を押すと、空のMarkdown文書を作れます。

標準設定は次の通りです。

- 文字コード: Shift-JIS
- 改行コード: CRLF

## AI回答を貼る

`AI回答を貼る` を押すと、AIチャットの回答を貼り付けるためのMarkdown文書を作れます。

1. `AI回答を貼る` を押します。
2. 編集画面に切り替わります。
3. AIチャットの回答を貼り付けます。
4. 必要なら見出しや箇条書きを整えます。
5. 保存します。


## マニュアルを開く

? を押すと、アプリ内でこのマニュアルを開けます。

## ショートカットキー

よく使う操作は、キーボードからも実行できます。

- `Ctrl + S`: 保存
- `Ctrl + P`: 印刷
- `Ctrl + O`: ファイルを開く
- `Ctrl + N`: 新規文書を作る
- `Ctrl + E`: 読む画面と編集＋ビューア画面を切り替える
- `Ctrl + Shift + E`: 編集のみ画面に切り替える
- `Ctrl + F`: 検索を開く
- `Ctrl + H`: 置換を開く
- `Ctrl + Shift + H`: 編集＋ヒント画面に切り替える
- `Home`: 編集中の行の先頭へ移動
- `Ctrl + Home`: 文書の先頭へ移動
- `F3`: 次を検索
- `Esc`: 検索・置換欄を閉じる

## 検索と置換

`Ctrl + F` を押すと検索欄が開きます。
検索したい文字を入れて `Enter` または `次へ` を押すと、編集画面で該当箇所を選択します。

`Ctrl + H` を押すと置換欄も使いやすい状態で開きます。
`置換` は現在選択中の一致箇所を置き換え、`すべて置換` は文書全体の一致箇所をまとめて置き換えます。

## ビューアから編集する

ビューアで直したい見出しや段落をダブルクリックすると、編集画面が開き、その少し手前の行にカーソルが移動します。
厳密に同じ文字位置ではなく、読みながら直したい場所の近くへ移動するための機能です。
編集＋ビューア画面の右側ビューアをダブルクリックすると、読む画面に戻ります。

## TeX数式を表示する

Markdown文書の中にTeX形式の数式を書けます。
ビューアとプレビューでは、KaTeXを使って数式として表示します。

文中に入れる数式は、次のように書きます。

```md
三平方の定理は \( a^2+b^2=c^2 \) です。
```

数式専用の行(段落)は、次のように書きます。

```md
\[
x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
\]
```

よく使う書き方は次のとおりです。

- 分数: `\frac{1}{2}`
- べき乗: `x^2`
- 根号: `\sqrt{x}`
- 2次方程式の解の公式: `x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}`

数式表示はローカルに同梱したKaTeXで行います。
インターネットに接続していなくても表示できます。

## よく使う独自機能

### 画像を入れる

Markdownの画像記法で、Web上の画像や同じフォルダーの画像を表示できます。

md表記:

```md
![シンプルMDロゴ](simple-md-logo.png:200)
![写真](photo.png)
![図](images/chart.png)
```

実際の表示:

![シンプルMDロゴ](simple-md-logo.png:200)

ファイル名だけを書いた場合は、開いているMarkdownファイルと同じフォルダーから画像を探します。
`simple-md-logo.png` はこのアプリに同梱されるロゴ画像です。
`images/chart.png` のような相対パスも使えます。

画像サイズも指定できます。

md表記:

```md
![シンプルMDロゴ](simple-md-logo.png:200)
![シンプルMDロゴ](simple-md-logo.png:200,100)
![シンプルMDロゴ](simple-md-logo.png:,100)
![シンプルMDロゴ](simple-md-logo.png:50%)
![シンプルMDロゴ](simple-md-logo.png:30mm)
```

- `:200` は幅200px、高さ自動です。
- `:200,100` は幅200px、高さ100pxです。
- `:,100` は幅自動、高さ100pxです。
- `%`、`px`、`em`、`rem`、`cm`、`mm` が使えます。

写真やロゴは、比率が崩れにくいので幅だけ指定するのがおすすめです。
高さ指定は、教材の図版をそろえたい時などに使います。
### 空欄を入れる

小学生向け教材などで、書き込み用の空欄を入れられます。
編集画面では `[brank]` の文字列をそのまま入力し、ビューアとプレビューでは枠線つきの空欄として表示します。

md表記:

```md
りんごが [brank] こあります。
3 + [brank] = 7
[brank] × 4 = 20
```

実際の表示:

りんごが [brank] こあります。

3 + [brank] = 7

[brank] × 4 = 20

空欄の大きさも指定できます。

md表記:

```md
小：[brank:s]
中：[brank:m]
大：[brank:l]
名前：[brank:line]
横長：[brank:6em]
縦横指定：[brank:6em,2em]
```

実際の表示:

小：[brank:s]

中：[brank:m]

大：[brank:l]

名前：[brank:line]

横長：[brank:6em]

縦横指定：[brank:6em,2em]

`[brank]` は `[brank:m]` と同じ中サイズです。
`[brank:line]` は、名前欄などで使う横長の記入欄です。
カスタムサイズでは `em`、`rem`、`px`、`cm`、`mm` を使えます。
不正な指定や大きすぎる指定は、中サイズに戻ります。

インラインコードやコードブロックの中では変換されません。

### コードをそのまま表示する

Markdownの記号や独自記法を変換せずに見せたい場合は、文字列をバッククォートで囲みます。

md表記:

```md
答えは `[brank]` と書きます。
```

実際の表示:

答えは `[brank]` と書きます。

複数行をそのまま表示したい場合は、行の前後を ` ``` ` で囲みます。
コードブロックの中に `[brank]` と書いた場合も、文字列のまま表示されます。

## 印刷する

`印刷` を押すと、現在の文書をビューア表示に切り替えて印刷できます。

印刷時は、上部のボタン、設定欄、編集画面、通知欄は紙に出ません。
本文だけを印刷する想定です。

印刷時の標準余白は、上 18mm、左右 18mm、下 18mm です。
本文に重ならないように、アプリ独自の印刷ヘッダーは表示しません。

印刷先は、Windowsの印刷画面で選びます。

印刷プレビューで紙の一番外側に日付、ファイル名、ページ番号、URLなどが出る場合は、Windowsの印刷画面側の `ヘッダーとフッター` 設定です。
不要な場合は、印刷画面で `ヘッダーとフッター` をオフにしてください。
## 保存する

`保存` を押すと、開いている元ファイルへ上書き保存します。

文字コードや改行コードが前回保存時と違う場合は、確認メッセージが出ます。
よく分からない場合は、標準おすすめの `Shift-JIS / CRLF` を使ってください。

新規文書やドラッグ＆ドロップで開いた文書など、元ファイルの場所がまだ決まっていない場合は、保存先を選ぶ画面が開きます。

本文の空行、手動改行、見出し位置の調整は、保存時に自動で詰めません。
保存時に変わるのは、選んだ文字コードと改行コードに合わせた保存形式だけです。

## 文字コードと改行コード

このアプリでは、文字コードと改行コードを画面上で確認・変更できます。

文字コード:

- Shift-JIS
- UTF-8
- UTF-16 LE

改行コード:

- CRLF
- LF
- CR

学校やWindows中心の環境では、まず `Shift-JIS / CRLF` をおすすめします。

## 未保存状態

画面上部の小バーに `保存済み` または `未保存` が表示されます。

編集したあと、保存していない場合は `未保存` になります。
保存すると `保存済み` に戻ります。

## 関連付けについて

.md ファイルをダブルクリックしてこのアプリで開きたい場合は、Windowsで関連付けを設定します。

すでに別のアプリが .md の既定になっている場合は、次の操作が必要になることがあります。

1. .md ファイルを右クリックします。
2. `プログラムから開く` を選びます。
3. `別のアプリを選択` を選びます。
4. `simple-md-viewer-editor.exe` を選びます。
5. `常に使う` にチェックします。

## v2.4での注意

このマニュアルは v2.4 の説明です。
今後の大改造で、保存方法、フォルダー操作、Markdownプレビューの機能は変更される可能性があります。

まずは次の使い方を中心に確認してください。

- .md ファイルを読む
- 必要なときだけ編集する
- Shift-JIS / CRLF で保存する
- AI回答をMarkdown文書として整理する
