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

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

[htmikan]

Markdownは箇条書きとかソースコードとか、プログラミング関係のドキュメントなら問題ないけど、表と図とかは絶望的に使いずらいので、決して一般的ではない。github使っていると、いつもそう思う。

[khtno73]

Markdowを使うことを目的化してはいけない。大きい組織では特にね。

[takilog]

エンジニア以外が関わる文書をすべてMarkdownは無理だし意味不明だろう，ただの傲慢とすら思える

[prbaybe]

目をそらした地獄の反対側にはまた違う地獄があるだけじゃないですかね

[TriQ]

markdownは大好きだけど非エンジニアに布教するには余りにもエディタが貧弱過ぎるんだよなぁ、せめて文書書いて選択してツールバーから修飾できないと布教は無理。Typoraはいい感じだったけど有料化しちゃったし

[auto_chan]

図表をWYSIWYGで編集できる便利なmarkdownエディタを作ったらwordやexcelになりましたってお話だ

[strawberryhunter]

図表の編集快適性をどうにかしてから議論しようよ。

[revert]

Markdownが便利なことに異論はないが、社内文書は膨大になりやすいので、まともな全文検索が出来ないのは実用上問題があるのよね。Markdownで記述した文書郡をどうやって管理するのかに興味があるな

[nyankosenpai]

いいよね、ドキュメントを書いて読んでもらえる文化のある会社。弊社、画像で設定送っても誰も見てくれないから全員毎回異なる設定をしています。ヨシ！

[versatile]

その昔、公文書全てXMLにするっていう恐ろしい話があった

[ducktoon]

一般人はテキストエディタを使いこなせないというか、テキストエディタ=Excelだと思っているのでMarkdownを強いるとExcelやWordでMarkdownを書くというわけのわからないことになってしまう

[ssids]

Markdown は箇条書きの功罪で書くのは楽だが読むのは言うほど楽ではないし、書くのが楽すぎて脳死で書き流しすることもあるから結局清書が要る場合も多い

[toaruR]

Markdown教、定期的に湧くよな(・ω・)

[yojik]

CMSか、もっと簡単にgithubと組み合わせ前提ならmarkdownが良いと思う。共有ディレクトリに置いておくみたいな運用だと、↓こういうブコメみたいな反論がくるし、補うメリットが出せない

[Xray]

なんだかんだ脳死で使えるWordとExcelが最強

[awawawann]

markdownをワードやエクセルに変えるのないかなあ。ありそげ。

[gwmp0000]

Markdown そんなに使いやすいかなあ タグ付け等できるのはいいかもしれないが 文書作ってソフトで丸ごとMarkdown化するでないと無理 はてな記法の方が楽

[rrringress]

前提がどこにあるかだな。口伝だらけでナレッジやプロセスが蓄積されないことが問題なら文書化しやすいツールでハードル下げるのはあり。その後の整理や分類も大事だ。

[fuji_haruka]

社内文書は書きやすさも確かに大事なんだけど、それより検索性とか関連する文書の整理しやすさとかメタデータ付与とか共同編集とかいろんな要求があり、文書のフォーマットよりどんなSaaSを選ぶかのほうが大事。

[favoriteonline]

規定管理システムはMarkdown＋gitで作ってほしいと思う。

[remonoil]

最近（思い）知ったのだがIT業界にも図しか理解できないタイプの人がいるらしい。そういう連中にMarkdownは全く逆効果になる

[circled]

個人的には一部Markdown、一部平文テキストかな。そもそもMarkdownを使う理由に「他の形式に変換しやすい」がある時点で、大多数は他のフォーマットを欲していることを自ら認めてるようなもので自己矛盾してる。

[udofukui]

メモをマークダウンでとってみようかな

[a96neko]

Markdown記法はGoogle Chatの記法と同じなのかな

[kaiton]

せめて、ワードのデザインテンプレートにしてくれたら、広まるかな？

[sigwyg]

Google DocがMarkdown構文に対応したタイミング.でこれ？　つまり… https://workspaceupdates.googleblog.com/2022/03/compose-with-markdown-in-google-docs-on.html

[t2y-1979]

本や論文のような、まとまったドキュメント書いたことないんやろな。メモだけで済むような業務ならそれでいいかもだけど。

[n2sz]

markdownはあんまりしっくりくるエディタに出会ってないんだよなあ。短めの文章ならいいんだけど長文書きにくい。

[suikyojin]

図や表は、Markdownに向いていないと思う。また、Markdownの方言なんかも重要な問題になってくる。

[arx0balest]

いいぞ。社外文章もMarkdownで書いていけ。

[azzr]

その場限りではなくある程度長く残す文章なら、方言の多いmarkdownより標準化されたasciidocがいい。

[tetzl]

一回Dropbox paperで書いたやつmarkdownで書き出したら改行周りとかぐちゃぐちゃになったので今のところ「markdown記法でプレーンテキストを書く」感じになっている

[taketack]

よむ

[tokidokidj]

markdownの好きなところはexportability/importabilityの観点なんだけど、結構「おれのmarkdown」がサービスごとに違って統一規格がほしいと常々

[yogasa]

Webで閲覧も編集もするなら Markdown でいいけど、ローカルにファイル置くんだったら Excel でいいだろ

[Futaro99]

技術者じゃない人もいるからなぁ

[yoshi-na]

構造化した文書をつくれれば（つくってくれれば）いいんだよ。その中でMarkdownは割とコストが低いと思うので一旦Markdownで書いて構造化を意識しよ？

[rryu]

Markdownなドキュメントはエディタやプレビューや変換などのMarkdownそのものではないものが必要になると利点が無くなるので、そういうものを使って無理やり導入するのは良く無いと思う。

[pokepirk]

セクション番号が自動でつけられたらもっと普及してると思う

[send]

ちょっとした数値レポートなんかも社内文書としてあると思うんだけど、流石にそういうのまで Markdown でやるのはないと思う