关于 Markdown 我总是忘记的小事,不得不去 Google 搜索

Avatar of Chris Coyier
Chris Coyier

DigitalOcean 提供适合您旅程各个阶段的云产品。立即开始使用 200 美元免费积分!

这主要是我自己用的。这些是我有时在 Markdown 中感到困惑的小事,我发现自己不得不搜索网络。所以我会写下来。把博客当作记忆扩展。

请注意,这些内容可能会有所不同,因为 Markdown 有 许多不同的变体

markdown=”1″

Markdown 语法(或大多数其他结构化 HTML 元素)中没有 <div> 的概念,只是 Markdown 支持 HTML,因此如果您愿意,可以直接使用 <div>。但是一旦您使用它,它内部嵌套的任何内容都不能是 Markdown。

### Header

<div class="special-class">
1. Nope
1. Not 
1. Happening
</div>

除了它可以!在许多(大多数?)Markdown 变体中,您可以在元素上放置 <div markdown="1">,它将允许 Markdown 在其内部使用。

### Header

<div class="special-class" markdown="1">
1. All
1. Fixed 
1. Up
</div>

多段列表和引用块

如果一个列表项需要包含多段文字,您不能仅仅断开多行并继续。下一段需要缩进才能被视为同一个列表项的一部分。否则列表将结束,并且会启动一个新的列表。

1. one paragraph

    more for 1st list item :)

1. another paragraph

引用块类似

> First bit.
> Second bit.

这里不会有换行符。这两个部分将位于 <blockquote> 内的同一个 <p> 中。要使它们成为多段文字,您需要在它们之间留空行。

> First bit.

> Second bit.

如果您希望它们完全是独立的 <blockquote>,中间没有任何其他文本,我不知道该怎么办。

转义字符

某些字符在 markdown 中有意义,例如 *星号* 使文本变为斜体。但是,如果您想实际显示星号怎么办?您可以使用反斜杠对其进行转义,例如 \*

您甚至可以转义反斜杠本身,这意味着 \\\

ID

Markdown 支持 HTML,因此如果您需要元素上的任何特殊属性,您可以直接使用 HTML。但最好不用。

Markdown 的不同变体以不同的方式处理它。

一种比较常见的方式是允许它们出现在标题中,如下所示

### Custom IDs {#custom-id}

某些变体会在所有标题上自动添加 ID。

这也可以 在客户端完成

图片

它与链接语法 [链接文本](url) 相同,只是它以感叹号开头。

![alt text](http://example.com/image.jpg)

更难的是将其嵌套为链接

[![alt text](image.jpg)](https://css-tricks.org.cn)

代码栅格上的语言

语言紧随第一组反引号之后。

```css
body {
  background: red;
}
```

表格

您基本上像绘制 ASCII 艺术一样绘制它们。注意,连字符用于表示标题行,冒号用于表示对齐方式

| header | header | header |
|--------|:------:|-------:|
| a      |    b   |      c |
| 1      |    2   |      3 |
| foo    |   bar  |    baz |

我想我并不孤单

这里有一个 关于其他人忘记什么内容的帖子