マークダウン記法は奥深く、楽しい — テキストだけで「伝わるドキュメント」を作る技術 - Qiita

マークダウン記法は奥深く、楽しい — テキストだけで「伝わるドキュメント」を作る技術 はじめに 皆さんは Markdown(マークダウン) を「見出しと箇条書きが書ける記法」程度に思っていませんか? 私もかつてはそうでした。しかし、個人開発...
🔒 149
💬 22
nguyen-oi結局Mermaidとか凝りすぎて「テキストだけでシンプルに」という初心を忘れていくのが様式美。エンジニアのドキュメント作成時間の半分はこれに溶けてる説
2026/04/12 09:00
taguch1marmeidで雑に絵も描けてここ10年くらいは必要充分だとは思ってる
2026/04/12 09:38
ravell手段が目的になってるやつ。
2026/04/12 10:28
knitcapmanngitで管理しやすい & AIでの利用に向いてるのは利点だけど、直感的に図形描画できないのはつらい。
2026/04/12 10:40
ndanna便利
2026/04/12 10:44
stabucky半分はMarkdownでなくMarmaidの話になっている。Markdownは見出しと本文と箇条書きの使い方が基本であり重要である。
2026/04/12 10:53★★★★★★
sisya3以降は通常のmarkdownでは使えないので、記事の大半が関係ない話になってしまっている。markdownはもう少し各所の独自ルールを取り込んで拡張規定をつくってくれないものか。
2026/04/12 11:26★★★
kotesakiメモ
2026/04/12 11:30
jeeraaやっぱり表かぁ。神エクセルを彷彿とさせる。時代の呪文だ。
2026/04/12 11:54
xiangzeMermaid
2026/04/12 12:43
kamiokandoドキュメントで小澤征爾さんが楽譜を見るだけで感動して涙を流すシーンがあったんだけど、慣れるとマークダウン見るだけで整って見えるんだろうか?
2026/04/12 13:05★★★★★★★★★
shira0211tamaほならXMLの方がもっと良いのでは?
2026/04/12 14:12
gyampy便利そう
2026/04/12 14:17
hiroyuki1983全てはExcelに通じる。Excelは唯一神
2026/04/12 14:21
ku__ra__gemermaid.jsはマジ便利だが、それはたまたまqiita書式に組み込まれてるだけでmarkdownとは別プロダクトなんだよなあ。
2026/04/12 15:00★★★★★★★
wwestppマークダウン形式は必要な知識になりそう
2026/04/12 16:38
TakamoriTarouあ゛?マークダウン記法ってあれでしょ?はてな記法のパクリでしょ?(違います  もともとはてな記法ネイティブだったが、最近ではすっかりMarkdownとのバイリンガル(これも違う
2026/04/12 16:41
FreeCatWorkマークダウン?ボクも cute に書けるように頑張るにゃ!
2026/04/12 17:17
tallmenテキストの構造化、インデントでネストさせる書き方が本質と思ってる
2026/04/12 19:10
fa11enprince“「テキストだけでここまで表現できるのか」 と驚く場面が何度もありました。”/それMarkdownでなくMermaidでは?Markdownの果たした役割はすごいが控えめに言って後ろスペース2個がクソ。方言でなくても良いものもある。
2026/04/12 20:12