VisualStudioCodeでMarkdownを書いて出力する方法

# はじめに
Markdownは基本的な文法を覚えればちょっとした文章を素早くきれいに書く事ができる。
Markdownを記載するエディタの中でもプレビュー機能やPDF,HTMLの出力が容易なVisualStudioCodeを使った方法をまとめる。
VisualStudioCodeのインストールから、Extensionと呼ばれる拡張の追加、HTMLへの出力までを手順に沿ってに記載する。

# VisualStudioCodeのインストール
VisualStudioCodeのダウンロードとインストールを行う。
[Visual Studio Code – コード エディター | Microsoft Azure](https://azure.microsoft.com/ja-jp/products/visual-studio-code/)

# プロキシを経由している場合の設定
インターネット接続にプロキシサーバを経由している環境の場合、このあと紹介するExtensionを導入で自動的にインストールされるchromiumのインストールに失敗する。インストールを正常に完了するために、事前に下記の手順でプロキシの設定を行っておく必要がある。プロキシを使用していない環境の場合は本章はスキップ。

【参考】 [Visual Studio Code に Proxy を設定する方法](https://qiita.com/cointoss1973/items/b3c84daeed90fd183501)

「Ctrl+,」を押下してSettigs画面を開き、以下キャプチャの赤枠部分（Open Settings(JSON))を押下する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/e3c3bcbd-e7b2-56fb-9c38-54d6f2d31be9.png)

settings.jsonが開いたら、以下のプロキシサーバの設定を追記する。
ユーザ名とパスワードがない場合は「【ユーザ名】:【パスワード】@ 」部分は不要。

```json:settings.json
"http.proxy": "http://【ユーザ名】:【パスワード】@ 【プロキシIP】:【ポート番号】/",    
"http.proxyStrictSSL": false
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/4b816750-3780-7838-b691-9fcbeef7958f.png)

#Extensionの追加
インストール直後ではMarkdownを出力する環境が整っていないため、Extensionと呼ばれる追加機能をインストールする必要がある。
今回は、「Markdown PDF」をインストールしてMarkdownの出力まで可能にする。
以下画面キャプチャの赤枠部分をクリックしてExtensionsの画面を開く（Ctrl+Shift+X でも開ける）。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/230c9010-ffc1-a8b2-6fde-38537af5d07c.png)

Extensionsの画面が開いたら「Search Extensions in Marketplace」の検索欄に「markdown」と入力して検索。何個目かに出てくるMarkdown PDFをクリックして「install」をクリックする。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/09d63788-fe7b-b1af-49dd-7c6db3cd9b46.png)


# Markdownファイルの作成・編集
インストールが完了したらさっそくMarkdownファイルを作成して編集する。マークダウンの拡張子は「.md」。
上記以外のMarkdown記法については以下あたりにまとまっているので参考。
[Markdown記法 サンプル集 - Qiita](https://qiita.com/tbpgr/items/989c6badefff69377da7)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/b2e4a14f-68de-8e5f-8402-051833efb6f3.png)


実際に出力した際にどうなるのかプレビューを確認しながら編集できる。
プレビューを開くにはメニューバーのView→Command Palette（Ctrl+Shift+P でも開ける）をまず選択する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/5fbfafe4-bf38-e0fb-baf1-4cca492e1c25.png)


Command Paletteが開いたら「markdown」と入力後、Markdown:Open Preview to the Sideを選択する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/259d9097-f096-f7a0-0c01-9078b489448c.png)


以下のキャプチャのように右側にMarkdownのプレビューが表示される。
なお、プレビューはCommand Paletteを使わずともショートカットコマンド（Ctrl + K → V）でも開くことができる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/8d760eb9-6f40-c0e8-9a32-bbc39a17426d.png)


# Markdownファイルの出力
記述したMarkdownファイルをhtmlに出力する。前述のCommand Paletteを開き、「Markdown PDF:Export(html)」を選択する。html以外で出力したい場合は任意で他の項目を選択する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/8353b3d3-0304-31bb-c3d0-dd9714b71fd8.png)

Markdownファイル（.md）ファイルと同じディレクトリにhtmlファイルが出力される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/161682/bdb761f5-80f7-4984-7249-de0f25a29d9e.png)


# おまけ　SVNにコミットする場合
環境によっては、SVNリポジトリに上記で作成したhtmlファイルを通常通りコミット後、URLで対象ファイルにアクセスした際に生のコードが出てきてしまう。mime-typeを「text/html」で設定することで生のコードではなく、HTMLの整形された状態でファイルを開くことができる。

```
% svn propset svn:mime-type text/html 【対象ファイル】
```