タグ

ブックマーク / qiita.com/e99h2121 (2)

  • すべての社内文書はMarkdownで書けばいいと思うこれだけの理由 - Qiita

    Markdownを社内に布教したい、というモチベーションからMarkdownを勧める理由をまとめたもの。 同じようなことを考える方へ、周囲への説得材料になると嬉しい。 1. Markdownを勧める理由 1-1. 圧倒的理由 全人類がマークダウンを学習すべき理由|情報デザイン力を鍛えよう Markdownとは (日Markdownユーザー会) をMarkdownで引用する。 Markdown(マークダウン)は、**文章の書き方**です。 デジタル文書を活用する方法として考案されました。特徴は、 - 手軽に文章構造を明示できること - 簡単で、覚えやすいこと - 読み書きに特別なアプリを必要としないこと - それでいて、対応アプリを使えば快適に読み書きできること などです。 Markdownはジョン・グルーバー(John Gruber)によって2004年に開発され、 最初は [Darin

    すべての社内文書はMarkdownで書けばいいと思うこれだけの理由 - Qiita
    greenbow
    greenbow 2022/04/04
    表の情報構造がわかりにくいのが致命的だと思うのよね。「表」という人類の発明を捨ててまでmarkdownにこだわるモチベーションは無い。 “マークダウンとは、情報構造がわかりやすい記法 である。”
  • 結局UMLとかシーケンス図とかAWSの図とかどれで描くと良いのよ?と思ったときの選択肢 - Qiita

    自身のプライオリティによりますが、いくつか。 Markdownで幅広く再利用性を利かせたい、長期的に丁寧に版管理したい 自分自身の操作性、描きやすさと、見た目 俄然手軽に、短期的に、Onlineでいつでもどこでも いずれかという視点で考えると良いのかなと思い、並べてみました。 1. 長期的に: Markdownで幅広く再利用性を利かせたい、丁寧に版管理したいなら Markdownで描くことのメリットは再利用性。 将来的に追記・編集、自分以外の誰かが手を入れる可能性が高い。 現在のドキュメントだけでなく多種説明資料、媒体に転用する可能性がある。 ...という点で差分管理をしたいなら、以下。 VSCodeでPlantUML、Mermaid 上記参考で以下。 Alt+D でプレビュー起動。 Ctrl + Shift + P でコマンドパレットを起動し、出力。 png, svg, eps, pdf

    結局UMLとかシーケンス図とかAWSの図とかどれで描くと良いのよ?と思ったときの選択肢 - Qiita
    greenbow
    greenbow 2022/04/03
    PlantUMLみたいなのは記法が分かりにくいから結局保守が辛くなるのよね。今まで使った中ではdraw.io が一番便利で混乱も起きない。
  • 1