45
47

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

ドキュメントはMarkdownにすれば管理がラクだし簡単にPDF化もできる

Last updated at Posted at 2017-02-17

はじめに

ドキュメントの管理の方法っていろいろあるけど、意外と__統一されてない__し、そもそも古いドキュメントだと__wordだったり__、更新履歴残ってなかったり…結構困ることありませんか??

nagedasu_woman.png

先日、実際この問題に直面して、ドキュメントの管理方法を考え直すことになったんです。
考えるべきポイントとしては、

  • 不特定多数のメンバー間での利用において、
  • 管理しやすくしたい
  • 更新しやすくしたい
  • 更新履歴を残したい
  • 保存形式は複雑なものではなく、単純で扱いやすいものにしたい
  • 簡単にPDF化できるようにしたい
  • etc...

などなど。
やっぱり複雑な__office(word,excel)の形式は避けたい__し、__簡単にPDF化できることは必須__ですね。その上で__管理も簡単にできたら最高!__と思ったんです。

管理方法・保管形式について考えてみたこと

GitHub で管理

doc_to_github.png

そうするとまず考えるのが管理の問題です。ここは__GitHub__に統一できるのがラクと思いました!
ポイントは、

  1. 有償ですが、privateでリポジトリを作成できること(物によってpublicでも)
  2. 更新がラク
  3. 更新履歴がバッチリ残せる

ちょうど自分たちのチームではアカウントがあったこともあり、GitHubを採用しました◎

Markdown で作成してPDF化する

markdown_to_pdf.png

次に、どの形式で書類を作るかです。幸い__GitHubはどんな形式のファイルでもpushできる__ので、形式は何でもOKです。ただ書類としては__PDF__であるか、__簡単にPDF化できるもの__がいいですね。PDFそのもので保管した場合は、面倒なのが編集です。PDFは編集できないので、元ファイルも一緒にアップする必要があります。なのでどっち道PDFにする前のドキュメントで管理する必要があります。
ではどうしたらいいでしょう?

PDF化できる形式と言えば__Word__や__パワーポイント__などが浮かびますが、書体や文字サイズなどが上手く統一されなかったり、勝手に変更になっていたり、__不特定多数のメンバー間での利用には適さない__部分があるため、あまりおすすめではないです。そういった部分を気にしないでよい形式として、Markdown があります。Markdown はQiita でもおなじみですが、Wikipediaには「書きやすくて読みやすいプレーンテキストとして記述した文書」とあるように、編集が本当に簡単です。

参考:Wikipedia
Markdown

あとはPDF化さえ出来れば…
早速調べてみたところ、方法はさまざまありましたが、一番簡単に出来そうなのが、
__テキストエディタのAtom のPackage を利用する方法__でした!
(その方法については[次の章](#テキストエディタのAtom のPackage を利用する方法)でご紹介します。)

ここまでひとまず考えたことをまとめると、

  1. Markdown で作成
  2. GitHub で管理
  3. PDF化して利用
  • [テキストエディタのAtom のPackage を利用する方法](#テキストエディタのAtom のPackage を利用する方法)

図1.png

というドキュメントの作成/管理体制がベストということがわかりました◎

テキストエディタのAtom のPackage を利用する方法

markdown_to_pdf_for_atom.png

  1. まずはテキストエディターのAtomをダウンロード・インストールします

参考:テキストエディタAtom(エイトム)とは?
GitHubの創業者が作られたもので、自由にカスタマイズ可能なオープンソースのエディタ。
(詳細:外部リンク

  1. 次に、下記の手順でAtomに__Package「markdown-pdf」__をインストールします
  • 「Atom」>「preferences...」>「Install」>「Install Packages」の下のテキストフィールドに「markdown-pdf」と入力し検索>「Install」をクリック
  • 日本語設定している場合は、「Atom」>「環境設定...」>「Install」>「パッケージのインストール」の下のテキストフィールドに「markdown-pdf」と入力し検索>「インストール」をクリック
  1. Markdown でドキュメントを作成します
  • ページ区切りには次のコードを使います:<div style="page-break-before:always"></div>
  1. 作成したMarkdown ドキュメントの上で「control + shift + C
  • 数秒後PDF化されます◎

参考:日本語設定方法
Package「markdown-pdf」をインストールする手順と同様に、「japanese-menu」を導入すると、メニューなどが日本語化されます。

とても簡単でした!

おわりに

いかがでしたでしょうか。ドキュメント管理に困っている方、少しでもお役に立てれば幸いです!
また、これからドキュメントを作成される方は参考にしていただければ嬉しいです。

45
47
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
45
47

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?