KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

md2docx

★ 36 Open GitHub ↗

Convert markdown to docx

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

md2docx
=======

convert markdown to docx

markdownファイルをwordのdocxに変換するスクリプトです。
* PowerShellスクリプトなのでWindows限定です。
* 動作確認はOffice 2010でのみ行っています。
* 確認出来ているのは、Windows 7 + PowerShell V3です。

使い方
------

バッチファイル化してあるので、そちらを使用します。
コマンドプロンプトより、以下のように入力します。

```Batchfile
> md2docx.cmd file.md
```

拡張子が **docx** に変更された、 **file.docx** が同じディレクトリに出来ているはずです。

もしくは、引数に何も指定しなければ、markdown file の入力を促すプロンプトが表示されるので、そこにエクスプローラなどから markdownファイルをドラッグアンドドロップしてEnterでもよいです。

対応記述形式
------------

markdownといっても、現在対応している記述はまだまだ少ないです。
また、word独自対応するためにmarkdownにおけるコメントを使用している部分があります。

### 見出し

```Markdown
# 見出し 1
## 見出し 2
### 見出し 3
#### 見出し 4
```

それぞれ、wordのスタイル [見出し 1] 〜 [見出し 4]に対応しています。

### 表題、副題

```Markdown
# 表題
# 副題
```

それぞれ、wordのスタイル [表題]、[副題]に対応しています。

### リスト

```Markdown
* リスト 1
* リスト 2
  * リスト2-1
* リスト 3

1. リスト 1
2. リスト 2
3. リスト 3

4. リスト 1
3. リスト 2
8. リスト 3
  
  9. リスト 4
1. リスト 5

```

通常のリストと、番号付きリストです。
インデントをつけると、生成されるword文書もインデントされます。
番号付きリストの番号は、0～9であればなんでも良いです。通常は
自動的に前行の番号の続きになります。
`` を入れると、次のリストは1から開始されます。

### 画像

```Markdown
![代替テキスト](https://raw.githubusercontent.com/yukimemi/md2docx/master/imgfolder/img.jpg)
![代替テキスト](https://raw.githubusercontent.com/yukimemi/md2docx/master/imgfolder/img.jpg)
![代替テキスト](https://raw.githubusercontent.com/yukimemi/md2docx/master/imgfolder/img.jpg)
![代替テキスト](https://raw.githubusercontent.com/yukimemi/md2docx/master/imgfolder/img.jpg)
```

画像の場所は、markdownファイルのある場所からの相対パスで記述します。
また、後ろに上記のように画像のサイズを指定することが可能です。
画像のサイズは縦横比固定なので、両方指定しても恐らくどちらか無視されます。
なので、片方だけ指定することも可能です。

### テーブル

```Markdown
| 列1     | 列2     | 列3     |
| てすと1 | てすと2 | てすと3 |
```

行頭、行後の「|」も必須です。

### 改ページ

```Markdown


```

改ページを挿入します。

### 改セクション
```Markdown


```

セクション区切りを挿入します。
セクション区切りは、「次のページから開始」になります。

他のセクション区切りを使用したい場合は、インラインマクロ
を使用して、以下のように記述出来ます。

```Markdown

```

セクション区切り(現在の位置から開始)

### インラインマクロ

```Markdown
右寄せ文章
```

`` でwordマクロ(PowerShell記述)が実行出来ます。

該当文章のみにマクロを指定したい場合に便利です。
この場合、「右寄せ文章」が右寄せになります。

提供されるwordのCOMオブジェクトは、以下の通りです。

```Markdown
$word      : Word オブジェクト
$doc       : Word Document オブジェクト
$selection : Word Selection オブジェクト
```

また、wordで使用出来る定数は、`$CONST.定数名`でアクセス出来ます。(まだアクセス出来る定数は少ない・・・)

### 複数行マクロ

```PowerShell
<!--!
  # Style change
  $doc.Styles.Item("表題").Font.NameFarEast = "ＭＳ Ｐ明朝"
  $doc.Styles.Item("表題").Font.Size = 20
  $doc.Styles.Item("表題").Font.Bold = $true

$doc.Styles.Item("見出し 1").Font.NameFarEast = "ＭＳ Ｐ明朝"
  $doc.Styles.Item("見出し 1").Font.Size = 16
  $doc.Styles.Item("見出し 1").Font.Bold = $true
  $doc.Styles.Item("見出し 1").AutomaticallyUpdate = $true

# Page setup
  $doc.PageSetup.TopMargin = $word.MillimetersToPoints(25)
  $doc.PageSetup.BottomMargin = $word.MillimetersToPoints(20)
  $doc.PageSetup.LeftMargin = $word.MillimetersToPoints(20)
  $doc.PageSetup.RightMargin = $word.MillimetersToPoints(15)

# Image size change
  $doc.InlineShapes | % {
    if ($_.Height -gt 200 ) {
      $_.LockAspectRatio = $CONST.msoTrue; $_.Height = 200
    }
  }
-->
```

``で終わる、この記述内はすべてPowerShellとして実行されます。
インラインマクロと同様、`$word`、`$doc`、`$selection`が使用出来ます。

``はそれぞれ、単独で行頭に記述されている必要があります。

このように、結局書式の設定部分は、wordマクロをガリガリ書くことになります・・・。
その代わり、wordマクロを(PowerShellにて)記述出来るので、その気になればなんでも出来る！はずです。

TODO
----

* 目次
* 引用
* 処理速度アップ

md2docx

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README