# MDエディタんの使い方

## 概要

MDエディタん（エムディー・エディタん、mdeditan）は、MarkDown記法を、WordPressのビジュアルエディタのような感覚で編集できるWindows向けのシンプルなエディターです。

## 初めての起動

ダウンロードしたzipファイルを展開し、mdeditanフォルダー内にあるmdeditan.exeをダブルクリックすることで、アプリが起動します。

<img src="reference/reference-20260827-200010.png" alt="reference-20260827-200010" width="381">

### Smart Screenが表示されたら・・・

環境によっては、下記のウィンドウが表示される場合があります。

![smartscreen1](reference/smartscreen1.png)

この画面が表示されたら、「詳細情報」をクリックして、表示された「実行」ボタンをクリックしてください。  
信用していただければ幸いです…。💦

![smartscreen2](reference/smartscreen2.png)

無事エディターが表示されたら起動完了です。

## できること

| 機能 | 内容 |
| --- | --- |
| ビジュアル編集 | 見出し / 太字 / 斜体 / 打ち消し / インラインコード / 箇条書き / 番号付きリスト / チェックリスト / 引用 / コードブロック / 水平線 / リンク |
| 表 | 挿入・行列の追加削除・セル結合分割・見出し行の切り替え・列幅のドラッグ調整 |
| 画像 | クリップボードから貼り付け (Ctrl+V) / ドラッグ&ドロップ / ツールバーの 🖼 から既存ファイルを挿入。MD ファイルと同じフォルダへ自動保存し、相対パスで参照 |
| 画像の加工 | ドラッグで表示サイズ変更。右クリックからその場でトリミング、テキスト・矩形・マウスカーソルの描き込み。元画像は `_originals` に退避されいつでも復帰可能 |
| 保存 | Markdown形式(.md) |
| 出力 | HTML / Word 文書 (.docx) / PDF / 印刷 |
| 見た目 | 各ブロックのスタイルはCSSで自由に設定可能 |
| 文字サイズ | Ctrl + / Ctrl - / Ctrl + マウスホイール で 8〜48px、Ctrl+0 で既定に戻す（表示のみで、マークダウンファイルに影響なし） |
| 本文の幅 | 「表示→本文の幅」で A4 縦の幅 / ウィンドウの幅に合わせる を切り替え |
| ハイパーリンク | テキストや画像にハイパーリンクを設定でき、CTRL+クリックでURLを開く。 |
| 文字コードの保持 | Shift-JIS、UTF-8、UTF-8(BOM付き）の読み込みに対応（自動判別）。保存時も読み込み時の文字コードを保持（文字コードの変更も可能） |

## キーボードショートカット

| 操作 | キー |
| --- | --- |
| 新規作成 | Ctrl+N |
| 開く | Ctrl+O |
| 上書き保存 | Ctrl+S |
| 名前を付けて保存 | Ctrl+Shift+S |
| 印刷 | Ctrl+P |
| 太字 / 斜体 | Ctrl+B / Ctrl+I |
| リンク | Ctrl+K |
| 元に戻す / やり直し | Ctrl+Z / Ctrl+Y |
| 文字を大きく / 小さく / 既定 | Ctrl++ / Ctrl+- / Ctrl+0 |

## 画像の扱い

### 画像を挿入する

画像の挿入方法は、下記の二通りです。

- 画像ファイルを指定して挿入
  
- クリップボードから画像を挿入
  

いずれの場合も、画像ファイルはMD（マークダウン）ファイルと同じフォルダ に保存されます。  
クリップボードから画像を貼り付けた場合は、`<MDファイル名>-<日時>.png` という名前で自動保存されます。  
そのため、画像を貼り付ける前に、MDファイルには名前を付けて保存しておく必要があります。

画像を多用するマークダウンファイルを作成する場合は、画像ファイルが沢山作成されますので、フォルダーを作ってその中にMDファイルや画像ファイルをまとめておくことをお勧めします。

### 画像を加工する

簡単な画像編集機能を備えています。

#### 画像のサイズを変更する

画像の右下の丸い部分をドラッグすることで、画像の大きさを変更できます。

#### 画像をトリミングする

画像を右クリックして、「トリミング」を選択すると、画像をトリミングすることができます。

#### 画像を編集する

画像を右クリックして、「画像を編集」を選択すると、画像の編集画面が表示されます。

<img src="reference/reference-20260827-204413.png" alt="reference-20260827-204413" width="449">

- 枠…指定した色、線の大きさで、枠を描画することができます。
  
- 塗り…指定した色で四角い塗りつぶしを描画することができます。
  
- テキスト…指定した色で文字を描画することができます。
  
- カーソル…マウスカーソルみたいなものを描画することができます。
  

いずれの編集も、一度保存すると修正ができませんが、元の画像に戻すことはできます。  
もし、やり直したい場合は、画像を右クリックして、「元の画像に戻す」をクリックしてください。

なお、元の画像は、「\_originals」フォルダーに保存されています。

### 使っていない画像ファイルを整理する

MDファイルと同一フォルダー内に、mdファイル内で参照していない画像ファイルを整理したい場合は、メニューの「表示→未使用画像ファイル一覧」をクリックして確認することができます。

![reference-20260827-202346](reference/reference-20260827-202346.png)

ファイルを削除したい場合は、対象のファイルをチェックし、「ごみ箱へ移動」をクリックしてください。

## 編集画面のカスタマイズ

### 文字の大きさの変更

表示されている文字を大きくしたい場合は、CTRL+「＋」をクリックすることで、少しずつ大きく変更することができます。

小さくしたい場合は、CTRL+「ｰ」をクリックしてください。標準の大きさに戻す場合は、CTRL+「0」をクリックしてください。

メニューの「表示」にも同様のメニューを用意しています。

### 本文の幅

文書の幅は、「表示→本文の幅」で、2種類のモードが選べます。設定は次回起動時も保たれ、HTML 出力にも反映されます。

| モード | 本文の幅 | 用途 |
| --- | --- | --- |
| A4 縦の幅 (既定) | 210mm − 左右 18mm = 174mm | 印刷・PDFと同じ位置で折り返すので、仕上がりを見ながら書くことができます。 |
| ウィンドウの幅に合わせる | 制限なし | 画面全体を使って文書を編集するときに向いています。 |

### 見た目の変更（CSSの修正）

文書の表示スタイルは、CSSファイルで設定されており、自由にカスタマイズすることができます。

メニューの「設定→スタイル設定 CSS」をクリックすることで、CSSファイルが表示され、好みに修正することができます。

## 印刷・印刷プレビュー

メニューの「ファイル→印刷プレビュー」で文書の印刷結果を確認できます。

このアプリでは、印刷はA4縦に固定されています。余白などの細かな設定はできませんのでご了承ください。当アプリのモットーはシンプルです。

メニューの「ファイル→印刷」で印刷を実行することができます。

メニューの「設定→印刷に日付とページ番号を入れる」にチェックをすると、印刷結果に日付、ファイル名及びページ番号が付加されます。これらを付けたくない場合は、チェックを外してください。

なお、ヘッダー・フッターのフォントなどを細かく設定することはできません。当アプリのモットーはシンプルなのです。

## 出力（HTML・Word文書（.docx)・PDF）

MDファイルを、HTMLファイル、Microsoft Word文書ファイル（.docx）及びPDF形式に出力することができます。

## チートシート

マークダウン記法のルールを忘れた！という方のために、チートシートを用意しています。

メニューの「ヘルプ→Markdown チートシート」を参照ください。

## アプリ設定の保存場所

本アプリの設定情報は、下記の場所に保存されます。

`%APPDATA%\MDエディタん\settings.json`
