2013-08-02 51 views
7

這對我來說一直是一個謎,因爲谷歌沒有幫助我,所以讓我問。GitHub在GitHub中實際使用的Flavored Markdown(GFM)在哪裏?

編輯:好的,我明白GFM在GitHub中無處不在,並且爲什麼GFM樣式中斷編輯不可用?它被關閉了嗎?我知道最初的MD規則。 我想在這裏確認的是GFM換行規則。謝謝。

我非常喜歡GFM,特別是對於直行換行方式。 https://help.github.com/articles/github-flavored-markdown 但是,我從來沒有能夠發佈我自己的Markdown與這條線喙模式。

例如,我將一些語法列表MD複製到GitHub上我的一個wiki的新頁面。

https://github.com/kenokabe/kenokabe.github.io/wiki/MarkDownGFM

正如你可以確認MD來源。

This is intended as a quick reference and showcase. 
For more complete info, see [John Gruber's original spec] 

應用了一條新線;但是,結果顯示沒有新行。

我錯過了什麼? GitHub Flavored Markdown(GFM)在GitHub中實際使用在哪裏?

(技術說明:降價這裏使用GFM換行符,所以沒有必要使用MD的雙線空間換行。)

這當然是這麼說的,但我發現這個MD採用2位BR方式。

+0

您可能想要更改問題的標題以反映其新內容。 –

回答

10

相反,其他的答案,GFM是僅用於其中文本只有通過GitHub的網站進入,不要在README.md,而不是在GitHub上的Wiki。

https://help.github.com/articles/github-flavored-markdown(強調)

GitHub上使用我們正在爲 消息問題,並評論叫 「GitHub風格降價」(GFM)。

這背後的原因是,README.md和維基是Git代碼庫的一部分,因此可以在網站,其中一個會合理預期(標準)之外克隆降價,而不是GFM。

更多關於GitHub的理由,見https://github.com/github/markup/issues/208#issuecomment-24927799

編輯:

語法高亮(Pygments來做)是從GFM分開,在那,GFM採用語法突出顯示,語法突出顯示的但是存在不引發GFM,因此爲什麼GitHub頁面將使用標準的Markdown換行符:它使用Pygments,但不使用GFM。

+0

謝謝。這就是我的想法,並希望證實。事實上,我曾計劃爲https://github.com/substack/stream-handbook製作一些頁面供我自己輸出,但發現使用非GFM換行符很難編輯,所以。我最終開發了我自己的內容管理系統。 –

0

當您在存儲庫首頁上顯示README.md文件時使用它,for example。另外,當你添加評論時,它是GFM。

+1

它也用於'Github Pages',可以用'Jekyll'解釋並翻譯成html。 WAY比寫直HTML,IMO更好。 – Houdini

+1

@胡迪尼,是的,在網站上幾乎無處不在,對吧? –

+0

https://github.com/kenokabe/heroku-buildpack-nodejs/blob/master/README.md這是我的一些README.md文件,我剛開始試過Hello/nWorld。我明白了,沒有換行符。我錯過了什麼? –

0

GitHub風格降價上使用:

和最低限度的

  • 你的回購的自述文件
  • 任何.MD文件在您的回購
  • 問題
  • 維基&頁評論(提交,拉取請求等)

    關於問題的說明:它似乎使用GFM的限制版本而不是wiki頁面或自述文件。

+0

謝謝@xero,你知道爲什麼GFM特定的換行符不適用於他們嗎? –

+1

np。不,我不確定。評論我認爲這是爲什麼他們不允許多行評論在這裏相同的原因。在回答上下文中沒有問題,但沒有評論上下文。 – xero

相關問題