Text::Hatena::Syntax
id:tociyukiさんがさっそく書き直してくださったので添削してみます。ただし、いちおうお断りしておきますが、これがベストの直しだというわけではありません。あくまでtociyukiさんの原稿をベースに赤を入れたらこうなるかなという程度のものです。また、全体を通じて変換前、変換後の例を見せるようにした方がよいですね。ぐっとわかりやすくなります。
以下、引用元はtociyukiさんの該当エントリです。
では、始めましょう。
Hatena::Text supports some simple markup language, which is similar to the Wiki format.
えーと、冒頭からナンですが、Hatena::Text ではなく、Text::Hatena ですよね？（以下同じ）
Paragraphs are created from one line. If you want to force a newline in a paragraph, you can use a break line markup of HTML.
一文め：これではあきらかに単複の対応が悪いので、たとえば Each (またはEvery) line becomes a paragraph. のように書き換えた方がベターかと思います。さらに言うと、Basically とか、unless otherwise specified のような断り書きをつけた方がなお親切です。
二文め：DokuWiki では without a paragraph でしたが、これはどちらでもいいのかな。いずれにしても break line markup は line break markup です。
Hatena::Text treats a blank line as an end mark of a block. So that a blank line after a paragraph does not affect an output. Different from it blank lines more than two are translated break lines.
一文め：as an end mark of a block の部分は少なくとも as the end 〜かと思います。mark もたぶん不要ですね。
二文め：この文脈なら So that の that はない方が自然です（So that を使うなら前の文とつなげた方がよいです）。affect an output は affect the output の方がたぶんベター。
三文め：Different from it で文を始めるのは変です。単に But とか However、あるいは何もなくてもいいような。blank lines more than two are translated break lines. はどう直したものかと思いますが、two or more blank lines are translated into line break(s). というところでしょうか。ちょっとおおざっぱですが。
Hatena::Text supports two kinds of headlines, such as section headers and simple headers. To create a section headline, start a line with a star followed by an anchor, a star, and some tags of categories. An anchor and tags are optional. If you omit it, Hatena::Text generates default anchors. More starts means deeper levels of simple headlines. You can use up to three levels of headlines.
一文め：そもそも two kinds なのかなあというのが一点。それから、such as 以下は形式内容ともにちょっと不自然なので、カンマ such as の部分を（セミ）コロンに変えてしまうとか、ふたつの headers をそれぞれ header / headline / one 等に変えるとか、いっそなくてもかまわないので such as 以下まるごと取ってしまうとかした方がよいかと。
二文め：some tags of categories のあと、and a section title のような表現を加えた方が親切かなと思います。
四文め：If you omit it は〜 omit them（ないし〜 omit）。generates default anchors の部分は内容的に〜 default headlines ないし〜 a default headline の誤り？（二文めが a section headline なので、ここも単数にした方がきれいです。逆にここで複数形にするなら二文めを始めとする似たような箇所をそれぞれ複数形にした方が整合性がとれます）
五文め：More starts means は More stars mean ですね。また、見出しの場合 deeper levels というよりは、むしろ smaller headlines ではないかと。of simple headlines の部分はない方がよいです。
六文め：上記の疑問をごまかすためにも、three levels of headlines よりは three stars にした方が無難かなと思います。
Hatena::Text supports ordered and unordered lists. To create a list item, start every line with a minus (-) for unordered lists or a plus (+) for ordered ones. More marks mean deeper levels. You can show the end of lists by a blank line.
二文め：To create a list item なら start a line with 〜ですし、To create a list なら start every line with です（四文めから考えると後者かなと思います）。また、後者の場合そもそも To create 〜はなくても可です。
四文め：the end of lists は、たぶん the end of the lists の方がベター。
Hatena::Text supports definition lists. To create a definition set, start every line with a colon followed by a term, a colon, and a description.
二文め：definition set は definition list ですね。ここも上と同じく To create 〜はなくても可です。
You can create tables by using a simple syntax. Table rows have to start and end with a vertical bar (|). If you change them headers, add a star at top for each columns.
三文め：内容的に To make（ないしturn） cells into headers, begin them with a vertical bar and a star. というところでしょうか。row や column の話ではないですよね。
Blockquotes are created from lines between a start mark (>>) and an end mark (<<). To create a start mark of a blockquote, start a line with two greater-than sign followed by a newline. To create an end mark, start a line with two less-than sign followed by a newline. Blockquotes may be nested.
この辺から以下、どうもすっきりしません。全体を書き直すと、
To make a blockquote, enclose paragraph(s) with >> (double greater-than sign) and << (double less-than sign) tags. These tags should be placed in separate lines; don't start quoting paragraphs with >> or end them with <<. Blockquotes may be nested.
という感じかなと思うのですが、これが最適かどうかは疑問が残るところ。
Preformatted texts are created from lines between a start mark (>|) and an end mark (|<). To create a start mark of a preformatted text, start a line with a greater-than sign followed by a vertical bar and a newline. To create an end mark, end a line with a vertical bar followed by a less-than sign.
これも上に準じます。
If you want to substitute entities for special characters of HTML in preformatted texts automatically, you can use strong preformatted texts. The characters to be replaced are less-than signs (<), greater-than signs (>), double quotes ("), and ampersands (&). Strong preformatted texts are created from lines between a start mark (>||) and an end mark (||<). To create a start mark of a strong preformatted text, start a line with a greater-than sign followed by two vertical bars and a newline. To create an end mark of it, start a line with two vertical bars followed by a less-than sign and a newline.
これはざっくり削って
To encode special characters into HTML entities, use >|| and ||< for >> and <<.（あるいは、replace >> and << with >|| and ||<.）
でいいような。必要なら special characters のあとに (>, <, ", &) のように例を入れるとか、元の二文めを続けるとか。
追加・間違いの指摘等ありましたらお気軽にどうぞ。
