5

不具合事象

Markdown ヘルプ を読んでいると、インラインコードの説明には、以下のように書かれています。私の翻訳が間違っていなければ、下記引用部の最後の文章 (太線にしました) には、「インラインコード内の HTML は手動でエスケープする必要がある」と書かれていると思います。

インラインコード [1]

Like code blocks, code spans will be displayed in a monospaced font. Markdown and HTML will not work within them. Note that, unlike code blocks, code spans require you to manually escape any HTML within!

しかし、<strong>text</strong><del>text</del> は実際のところ、私が手動でエスケープしなくともエスケープされた状態で表示されます。確かに code 要素単体では、 code 要素内に「HTML 要素として解釈可能な文字列」があれば、それは HTML 要素として解釈されます。しかし、上記で引用した説明はMarkdown のインラインコードの説明なので、いきなり code 要素の特性について説明しているのであれば、不自然だと感じますし、それを書いておく意義もあまり無いと思います。

また、wmd.ja.js を読むと、インラインコードが生成される際、 makeHtml 関数が呼び出され、その中で x 関数が呼ばれていることがわかります。詳しい道程は省きますが、このようにして、インラインコード内の「HTML 要素として解釈可能な文字列」はエスケープされています。これは「インラインコード内の HTML は手動でエスケープする必要がある」という説明と食い違っています。

function x(e) {
    return e = e.replace(/&/g, "&amp;"),
    e = e.replace(/</g, "&lt;"),
    e = e.replace(/>/g, "&gt;"),
    e = M(e, "*_{}[]\\`~", !1)
}

改善案

もし当該箇所の英文の解釈に間違いが無ければ、この一文は不要であるため、削除してしまうことを提案します。ついでに翻訳案も載せておきます。

インラインコード

Like code blocks, code spans will be displayed in a monospaced font. Markdown and HTML will not work within them.


インラインコード

コードブロックと同様に、インラインコードも等幅フォントで表示されます。Markdown と HTML はインラインコード内で機能しません。

1
  • 3
    もしかすると <code><sub>aaa</sub></code> みたいなのがエスケープされない話と混同されて書かれたのかもしれないですね(実際されません)。探したら、英語版SOのメタで似たような投稿を見つけました: Code formatting article in help center is confusing
    – nekketsuuu モデレーター
    Commented 2019年10月30日 12:32

1 件の回答 1

1

以下の通り、@supaさんの翻訳案が(日本語版に)反映されましたのでここにお知らせ致します🙇‍♀️。

画像の説明をここに入力

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。