Markdownアンチパターン

いろいろあるけど、思ひついたら足してく

http://qiita.com/tadsan/items/6fb4523eb87102496628.md でこの記事の原文が見られるよ

見出し

見出し/小見出しをつけない

• 文章の区切りがわかりにくい

■変な記号を見出し代りにする

• 誰も得しない

リスト記法

変な記号をリスト記法の代用にする

・りんご
・バナナ
・みかん

1. 東京都
2. 大阪府
3. 京都府

ソースコード

コード記法使はない

• だめなやつ
  • dir 変数でディレクトリを参照する
• こうしたかった
  • __dir__ 変数でディレクトリを参照する

コードブロック使はない

Fizzif ($i % 5 === 0) { ?>Buzz<?php } elseif ($i % 3 !== 0) echo $i;

?>

execute('git rev-parse --verify HEAD', $output, $return); if (!isset($output[0])) { throw new \RuntimeException; } return $output[0]; } } * 空行がみっともない上に、コードブロック記法と衝突して変な感じになってる * Qiitaだと数式と衝突してすごい変な感じになる # 段落/改行 ## 文中で改行する 文章中の改行をどう処理するかは、Markdownエンジンの種類とか 変換オプションによって変化する。Qiitaの場合は改行が`
`に変換されちゃうから 不用意に改行を入れるとすごい不恰好な文章になるよ。 ## 一文ごとに段落 文章の最後につける`。`を句点と呼ぶ 私たちは小学校の国語の授業で、段落には意味段落と形式段落があることを習った 意味のまとまりを無視して一文ごとに段落を作ると文章が散漫とする これはただの散文詩^[ポエム]だ # 引用 > 我輩は猫である。 引用文から空行を空けずに自分の文章を書く 引用の次の行には空の行がなければならない。