DotMDブログ。Markdownの疑問を、ひとつずつ。
Markdownの疑問にひとつずつ答える短い記事です。コピーできるコードと、表示されたときの見え方の説明つき。
macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。
要点
ここではDotMDが、表やコードブロック、折りたたみセクションの作り方、PRDの書き方、AIが書いた仕様のレビューといった、Markdownの小さな疑問に答えます。各記事は、まず書き方を示し、そのあとで詳細とよくある間違いを説明します。アプリそのものについては、ガイドをご覧ください。
新着記事
新しい順。
AI仕様書レビューのチェックリスト
AIが書いた仕様や計画をレビューするためのチェックリスト：範囲、エッジケース、データ、テスト、ロールバック。
PRDテンプレート
コピーして使えるMarkdownのPRDテンプレート。AIエージェントが実装に使える、番号付きの要件つき。
CLAUDE.mdとAGENTS.mdの違い
CLAUDE.mdを読むエージェントとAGENTS.mdを読むエージェントの違い、指示を1か所にまとめる方法。
Mermaidフローチャート
Mermaidのフローチャートの構文：方向、ノードの形、リンク、サブグラフ、図が崩れる間違い。
画像
画像の構文、相対パス、サイズの指定、中央揃え、キャプションの付け方。
コードブロック
フェンス付きコードブロック、シンタックスハイライト用の言語名、入れ子のバッククォート、インラインコード、diff。
折りたたみセクション
detailsタグとsummaryタグによるドロップダウン、そして内側の空行のルール。
Markdownの改行
Markdownが行をつなげてしまう理由と、改行する3つの方法：スペース2つ、バックスラッシュ、brタグ。
Markdownのタスクリスト
- [ ] と - [x] でチェックボックスを書き、入れ子にして、表示される場所を確認する。
Markdownの表
表の構文、列の配置、セル内のパイプや2行目、幅の広い表。
ブログに関するよくある質問
DotMDのブログには何がありますか？
Markdownの構文を扱う短いハウツー記事です：表、タスクリスト、改行など。どの記事にもコピーできる例があります。
記事はどのMarkdownの方言を使っていますか？
CommonMarkとGitHub Flavored Markdownです。GitHubやほとんどのMarkdownアプリが従う方言で、アプリによって違いがある場合は記事の中で触れています。
例が整形された状態で見られる場所は？
ファイルをMarkdownリーダーで開いてください。Mac用のDotMDなら、表、タスクリスト、改行が整形されて表示され、閲覧は無料です。Markdownを読むをご覧ください。