2013-02-27 4 views
10

これまでのマークダウンと脚注

私はMarkdown構文の主なソースであると思われるdaringfireball.netのMarkdown: Syntaxを参照しています。マークダウンと脚注:最も自然なフォーマットがありませんか?

Markdownは、メールとニュースグループの既存の書式に基づいていることが知られています。

Blah, blah [1] blah, blah. 

[1] http://somesite.com/somepage.html#someanchor 

驚くべきことに、この非常に一般的な形式は、主値下げ参照の一部ではありません:メールやニュースグループでは、私は多くの場合、脚注や転送の参照のためにこのような何かを参照してください。それだけのようなものを知っている:

Blah, blah [some title][id] blah, blah. 

[id]: http://somesite.com/somepage.html#someanchor 

をそして前者は非常に一般的である一方で、私は、ニュースグループまたはメーリングリストのいずれかで自然にこれを使用して任意のを見たことがありません。

Blah, blah [^id] blah, blah. 

[id]: http://somesite.com/somepage.html#someanchor 

クローサー、私はまだニュースグループやメールでこれを使用して誰も見たことがない:十分に異なっている間

私は、一般的な自発的な用法に近い何かを持っているPHP Markdown Extraと呼ばれるものを、見つけることができます。

質問

そんなに一般的な使い方でも、私が知っている任意のバリアントの一部ではない主な値下げ参照の一部ではなく、なぜ私は疑問に思います。誰かがこれについて何らかの理由を知っているなら、私はこの理由を知ることに興味があります。一方、非常に一般的な使用であり、脚注または転送参照(この記事で紹介された最初のもの)を書くのに最も自然な方法を含むマークダウンの変形を欠いたようなものを見逃した場合は、それを知りたい。

良い一日を過ごしてください。

答えて

1

Markdownのバリエーションや、脚注を実装している「フレーバー」があります(上記のPhp Markdown Extra以外)。私が知っているのはPandoc's Markdown,R MarkdownScholarlyMarkdownMultiMarkdownです。

私は脚注がこれらの変化のすべてにこのように動作信じている:。。[^]これは脚注でいくつかのテキストです

、別の[^]

[^]:ここにあります最初の脚注。
[^]:ここに2番目の脚注があります。

またはインライン:

これは脚注といくつかのテキストである[^ここで最初の脚注である。]、別の[^ここで第二の脚注である。]

彼らは。どちらもこの方法でレンダリングする必要があります。

これは脚注のテキストです。 そしてもう1つ。ここ


  1. 最初の脚注です。 ↩
  2. ここに2番目の脚注があります。 ↩

あなたは、例えば、あまりにも脚注へのリンクを追加することができます。

を。これは、脚注やリンクをいくつかのテキストである[^ここでリンクと脚注の例です。終わり。 [リンク](次のようにレンダリングする必要がありますhttp://stackoverflow.com)]

:。

これは脚注でいくつかのテキストです


  1. ここでは、脚注の例です。最後にリンクがあります。link
あなたはVSCodeエディタなど アトムを使用する場合は210

ところで、あなたは拡張子Markdown Preview Enhancedを追加することもできます。名前のとおり、入力時にレンダリングされたテキストをプレビューすることができます(previewing and exporting with Pandocをサポートしています)。

7

...なぜ、あまりにも多くの一般的な使用法は、主要なマークダウン参照の一部ではなく、私が知っている変種の一部でもありません。

それのいくつかはHow do I format my posts using Markdown or HTML?ごとに利用可能であるように見えます:

リンク

Here's an inline link to [Google](http://www.google.com/). Here's a 
reference-style link to [Google][1]. Here's a very readable link to 
[Yahoo!][yahoo]. 

    [1]: http://www.google.com 
    [yahoo]: http://www.yahoo.com/ 

アドバンスドリンク

リンクが表示されますこれは、title属性を持つことができますホバーオン。タイトル属性も追加できます。リンク自体がどこに行くのかをユーザーに伝えるのに十分説明的でない場合に役立ちます。

Here's a [poorly-named link](http://www.google.com/ "Google"). 
Never write "[click here][^2]". 
Visit [us][web]. 

    [^2]: http://www.w3.org/QA/Tips/noClickHere 
     (Advice against the phrase "click here") 
    [web]: http://programmers.stackexchange.com/ "Programmers Stack Exchange" 

またメタでMarkdown footnotes?を参照してください。ページにはMarkdown With Footnotesが記載されています。

+0

ポインタのおかげで、それはStackOverflow固有であり、標準のMarkdownではありませんが。私はこの問題についてMarkdown標準の著者に連絡しようとしましたが、決して答えを受けなかったことを覚えています。 – Hibou57

関連する問題