MacでMarkdownを快適に書くために使用しているツールを紹介するよ

# 概要
- Markdownとはプログラマご用達のドキュメント用マークアップ言語です。
    - 構造的に文章がかけることが良い点だと感じます。
    - 習得までの敷居が低いのも良いですね。
- そんなMarkdownを書くときに便利なツール類を紹介します。
- 有名なものも多いですが、既知の方は知らないものを中心に見ていって下さいませ。

# [Create Link \- Chrome ウェブストア](https://chrome.google.com/webstore/detail/create-link/gcmghdmnkfdbncmnmlkkglmnnhagajbm?hl=ja)

- テキストを選択した状態で`shift+command+c`をすると`[選択中のテキスト](URL)`の形式でクリップボードにコピーしてくれるChrome拡張機能
- WEBページで参照を貼る機会は多いので、これがあると作業がかなり捗ります。
- 似たような拡張機能は他にもあるでしょうし、好きなものを選択すればいいと思います。
    - （拡張機能は廃盤になっていることが結構あるので…）
![-w792](https://i.imgur.com/a4fmSE0.jpg)
![-w686](https://i.imgur.com/LYPAtuP.jpg)

# [Imgur Uploader](https://qiita.com/IKEH/items/3da357cc50030f3bc55d)

- Markdownで画像を挿入するためのMacアプリです
    - 自作のアプリです。ダイレクトマーケティングで申し訳ないです…でも結構便利なのです。
- クリップボードにコピーした画像をImgur(大手画像ホスティングサービス)にアップロードし、markdownの形式で自動で貼り付けを行います。
- markdown形式以外にも独自に設定ができたり、カスタムクリップボードにコピーするだけの設定もあります
- Imgurにアカウント登録が必要なのが少しネックかもしれません。
    - アカウント登録が不要で画像貼り付けができるアプリ（例：[HackMD](https://hackmd.io/)）もありますが、画像の消去や後から管理ができないという不便さがあります
- 動作例
<blockquote class="twitter-tweet" data-partner="tweetdeck"><p lang="ja" dir="ltr">（外部埋め込み用です） <a href="https://t.co/J2AnrfZvYf">pic.twitter.com/J2AnrfZvYf</a></p>&mdash; IKEH@iOS_Apprentice (@ikeh1024) <a href="https://twitter.com/ikeh1024/status/1198873071085469696?ref_src=twsrc%5Etfw">November 25, 2019</a></blockquote>
- アプリの外観
![-w869](https://i.imgur.com/BhIDAFK.jpg)

# [Dash](https://kapeli.com/dash)
- 私の主な利用方法として、クリップボードにコピーしたコードを言語毎にコードとしてペーストできるようにスニペットを設定しています
- 下記はクリップボードのコードを、`;py`と押下してPythonとして記述する例です。

![Dec-17-2019 15-49-46](https://i.imgur.com/FOb08Cl.gif)
![-w780](https://i.imgur.com/Kxoy1dW.jpg)

## スニペットの登録例
- コードの貼り付け用
- キーは`;py`


>\`\`\`Python
>@clipboard
>\`\`\`
>
>@cursor


- Qiita記事のアウトライン用
- もっとフォーマットが詳細になったときに便利だと思います
- キーは`;qiita`

>\# 概要
>@cursor
>
>\# GitHub
>
>
>\# 参考
>
>
>\# 実装

# [Clipy](https://clipy-app.com/)
- クリップボード拡張のアプリです。
- 1つのページで複数コピーしたい場合に、いちいちページ遷移をしなくて済むようになります。
- クリップボード拡張の代替アプリもいくつかあると思いますので、好きなものを使用すると良いです。
    - [Alfredを使いこなせてない君に！【Alfredの使い方完全版】](https://qiita.com/jackchuka/items/ccd3f66f6dd00481b98b#clipboard-history)

![-w468](https://i.imgur.com/j2bI7wk.jpg)

# エクセル・Markdown間の形式変換のWEBアプリ
## 概要
- エクセルで簡単に表を作って、それからMarkdownに変換したいときに使うWEBアプリです。
- 下記2つが使ってみて良さげでした
    - [Copy Table in Excel and Paste as a Markdown Table \| thisDaveJ](https://thisdavej.com/copy-table-in-excel-and-paste-as-a-markdown-table/)
    - [Markdown Tables Generator](http://www.tablesgenerator.com/markdown_tables)

## 参考
- [Excel からのコピペで Markdown Table を作る](https://qiita.com/yuusuke510/items/9fbb722bf147e303fd72)

## 作業例：[Copy Table in Excel and Paste as a Markdown Table \| thisDaveJ](https://thisdavej.com/copy-table-in-excel-and-paste-as-a-markdown-table/)
- Excelで表を作成してコピー

![-w165](https://i.imgur.com/N7YNEpL.jpg)

- 貼り付けのワンアクションだけですぐに変換されるのが良い

![-w629](https://i.imgur.com/yqjLgv9.jpg)

## 作業例：[Markdown Tables Generator](http://www.tablesgenerator.com/markdown_tables)
- Excelで表を作成してコピー

![-w165](https://i.imgur.com/N7YNEpL.jpg)

- 下記を選択

![-w450](https://i.imgur.com/Mj0KAFY.jpg)

- 貼り付け

![-w597](https://i.imgur.com/6Ud7k8a.jpg)

- 作成完了

![-w1012](https://i.imgur.com/PsDMzy3.jpg)

# Markdown用エディタ
- Markdownを語る上で最も重要な要素ですが、エディタ論争が起きそうですね…
- また私も触ったことのあるエディタが限られるので、独断と偏見ということを前置きしてから紹介します。
- 未だに理想のエディタを探しています。皆のおすすめを教えて欲しいです。

## [MWeb for Mac](https://www.mweb.im/)
### 概要
- 中国の方が個人で作られている有償アプリです。
- 現在メインで使用しています。
- 試用版もあるので興味がある方は、是非使ってみてください。

### 利点
- 欲しい機能がほぼ揃っていること
    - 快適なMarkdown編集機能・ショートカット
    - 見出し別のアウトライン表示
    - 画像貼り付け可能（ローカルに保存）
    - ローカルの画像を各種サービスにアップロード可能
    - PDF・htmlへの書き出し

### 欠点
- 有償（$19.99）なこと
- iCloudでの同期が怪しい（一方の反映されないなど）
    - 結局差異がでて収拾がつかなくなったので、現在は1機のみの運用としています
    - 私の使い方が間違っていたかもですし、また1年前の話なので今は直っているかもしれませんね。
- 直リンで画像を指定している場合に、プレビューとの対応がずれる

![-w1395](https://i.imgur.com/vjnxes8.jpg)

- 出力時に一部の漢字が中国のもので表示される
    - 正直そこまで気にならないです

![-w444](https://i.imgur.com/zNPITsD.jpg)

- 表の作成機能に癖がある（1年使っても全く使えてないです…）

![-w451](https://i.imgur.com/0ilvcyl.jpg)

## [HackMD](https://hackmd.io/)
### 概要
- WEB上で使えるMarkdownエディタ

### 利点
- デバイス間の同期や同時編集など、クラウド関連が強い
- 画像貼り付けが可能（Imgurへの匿名アップロード）
- 独自フォーマットの記述が可能（蛍光ペンなど）
    - 互換性がないのでここは良し悪しかも

### 欠点
- 表作成がテンプレの貼り付けのみで弱い
- 見出しのアウトライン表示ができない

## [StackEdit](https://stackedit.io/)
### 概要
- WEB上で使えるMarkdownエディタ
- Googleドライブで開くアプリに指定できる
- 良いと思うのですが、欠点に書く通りあまり信用していないです…

### 利点
- 編集がしやすい
- アウトライン表示可能

### 欠点
- 画像貼り付け不可
- ノートが同名で増殖する
    - StadkEdit上で削除してもGoogleDrive上で削除されないのが訳が分からなくなる原因か…？
    - 内容も同じです…ワケガワカラナイヨ。
- 私のメディア・リテラシーが低いだけかもしれないですね…

![-w258](https://i.imgur.com/NZhRf5k.jpg)

# Finder：右クリックでテキストファイルを作成
- 任意の場所に`xxx.md`ファイルを作成したい場合に手軽に作成するための設定
- 設定手順は[Mac OSXで右クリックで新規ファイルを作成](https://j-wort.hatenadiary.org/entries/2012/12/23)などを参照ください。

![-w698](https://i.imgur.com/NWTwiDt.jpg)

# Twitter（動画シェア）
- Qiitaに動画を貼りたい場合Twitterの埋め込みが便利です（というよりも他にあるでしょうか…？）
- 下記からツイートを埋め込む用のコードが取得できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/198225/c6ae4c5e-4734-d16a-5665-d9695d2c6feb.png)

# まとめ
- 以上私がMarkdownを書くときに便利だな〜と思っているツールの紹介でした。
- その他良いツールがあるよというのがありましたらコメントしていただけると助かります。
- Markdownツール界はまだまだ改善の余地があると思います、特にエディタ…素晴らしいアプリの台頭を願っています…！
- それでは快適なMarkdownライフを！