blog [译] GitHub 风格的 Markdown 语法

本文已过时，最新版本已迁至：

[译] GitHub 风格的 Markdown 语法

[译] GitHub 上的书写方式

Jul 07 '13 05:07 cssmagic

有一点比较困扰的是，我不知道怎样把 ``` 标记为代码。连输 5 个 ` 并不会得到期望的结果。

Jul 07 '13 07:07 cssmagic

``` 的行内代码大概只能让解析器添加考虑这种特殊情况。Fenced code blocks 我的翻译是围栏式代码块，对应空格式（缩进式）代码块。

Jul 07 '13 10:07 yanxyz

@yanxyz 谢谢，我原先也想直译的，但似乎没见过类似的称呼，感觉不够直观，所以加工了一下。如果这已经是程序语言的常见术语，或者是一个成熟的译法，我会改过来。很高兴有人对我的翻译提意见 :smile:

Jul 07 '13 10:07 cssmagic

@cssmagic 只是我个人的意见。我翻译过php markdown extra，觉得Fenced code blocks比较形象，直译能保留这种形象感。

Jul 07 '13 10:07 yanxyz

@yanxyz 谢谢，已更新。

Jul 07 '13 14:07 cssmagic

不错~

Jul 08 '13 02:07 myst729

zen mode 经常使用，不过那个按钮在有滚动条出现的时候就悲剧了，可能是偷懒不想用 JS 吧不知道是否有纯 css 的解决方案呢？

Jul 08 '13 08:07 edokeh

@edokeh 不太确定你的意思。我试了一下好像没发现异常情况。

Jul 08 '13 09:07 cssmagic

qq20130708183449

Jul 08 '13 10:07 edokeh

zen

@edokeh 看起来 GitHub 开发团队用的是 Firefox……

Jul 08 '13 12:07 cssmagic

我去。。果然 FF 好的，这个滚动条的出现位置是有什么 CSS 上的讲究嘛？

Jul 08 '13 13:07 edokeh

@edokeh 这是FF的bug……

Jul 08 '13 13:07 myst729

@edokeh 不同浏览器对 padding 与滚动条的布局关系的理解不一致。具体谁更标准我还没深入研究过。

Jul 08 '13 13:07 cssmagic

@cssmagic FF这个是个奇葩，其他任何元素都没见过padding会把滚动条一起带跑的吧…… 规范不贴了，都找得到

Jul 08 '13 13:07 myst729

原文版本更新到 2013-07-07，向支持团队反馈的笔误均已修正。

Jul 10 '13 02:07 cssmagic

@yanxyz 关于三个反撇号，我问过支持团队，有解决方案了。写成 ```` ``` ```` 即可。看起来很疯狂，但确实管用。而且我发现了另一个真相，实际上 <code></code> 标签在 GitHub 这儿是支持的！！！

Jul 11 '13 06:07 cssmagic

markdown 里一直都可以嵌入 HTML 啊 [挖鼻屎] 不光是 GitHub 这里……

Jul 11 '13 10:07 myst729

@myst729 这取决于解析引擎的具体实现吧。

Jul 12 '13 05:07 cssmagic

@cssmagic 哈哈，这么多

Jul 13 '13 02:07 yanxyz

@cssmagic markdown 语法 http://daringfireball.net/projects/markdown/syntax#html 目前的各种实现——包括 GitHub ——基本上都是它的超集。

Jul 13 '13 02:07 myst729

@myst729 谢谢提示。不过，（我没有能力研究各种 Markdown 解析引擎的源码，只是纯粹主观臆想，）我总是感觉规范是一回事，实现又是另一回事。这种关系就好像 W3C 与浏览器、CommonJS 与 Node 等等。所以我倾向于认为，各种解析引擎究竟对 Markdown 规范具体支持到什么程度，要试了才知道。

另外，这段话是这样说的：

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself.

显然 <code></code> 标签不在此列。

Jul 13 '13 04:07 cssmagic

Emoji 代号速查： http://www.emoji-cheat-sheet.com/

Jul 17 '13 05:07 cssmagic

非常谢谢~ 英语渣的痛啊。

Aug 03 '13 04:08 mistkafka

赞！虽然之前一直看原文来着

Nov 16 '13 03:11 laike9m

呃好像才发现我没有写一个转字。不是我翻译的。 MistKafka

On Nov 16, 2013, at 11:24, laike9m [email protected] wrote:

赞！虽然之前一直看原文来着

— Reply to this email directly or view it on GitHub.

Dec 04 '13 08:12 mistkafka

```，在中间的反引号前后各加一个空格。输入几个反引号就要在外围多加1+n个。。

Jan 02 '14 13:01 xaolex

官方文档更新了，添加了删除线的写法：

~~Deleted~~ 将渲染为 ~~Deleted~~

Jan 15 '14 05:01 cssmagic

GFM现在支持表格了。

表格

你可以使用若干列文字并于第一行下面用转折号-分开它们，然后用管道符|隔开每一列：

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

为了看上去美观，你也可以在两端加上额外的管道符：

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

注意顶部的虚线不需要准确匹配表头文本的长度：

| Name | Description          |
| ------------- | ----------- |
| Help      | Display the help window.|
| Close     | Closes a window     |

你也可以在其中包括内联Markdown元素，比如链接，加粗，斜体或删除

| Name | Description          |
| ------------- | ----------- |
| Help      | ~~Display the~~ help window.|
| Close     | _Closes_ a window     |

最后，通过在表头行加入冒号:，你可以决定文本是左对齐，右对齐，还是居中：

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

一个在最左边的冒号表示一个左对齐的列；一个在最右边的冒号表示一个右对齐的列；两边都有的冒号表示一个居中的列。

最后（这里不再是译文了），加上我自己的一个示范：