这主要是我自己用的。这些是我有时在 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)
相同,只是它以感叹号开头。

更难的是将其嵌套为链接
[](https://css-tricks.org.cn)
代码栅格上的语言
语言紧随第一组反引号之后。
```css
body {
background: red;
}
```
表格
您基本上像绘制 ASCII 艺术一样绘制它们。注意,连字符用于表示标题行,冒号用于表示对齐方式
| header | header | header |
|--------|:------:|-------:|
| a | b | c |
| 1 | 2 | 3 |
| foo | bar | baz |

我想我并不孤单
这里有一个 关于其他人忘记什么内容的帖子。
使用 HTML 注释
> 引用块 1
<!-- -->
> 引用块 2
变为
我还应该指出,人们一直在推动标准化 Markdown 语法,这导致了 CommonMark。您概述的许多功能 *不* 包含在该标准中,并且正在以各种方式讨论作为核心语言的扩展。
仅需更详细地说明
markdown=”1″
使用 CommonMark 时不需要此项,因为打开/关闭标签本身有效,它只需要用空行关闭即可,例如:
请注意标签**之后**的空行,它之前的空行只是为了美观。
多段列表和引用块、转义字符、图片、代码栅格上的语言的工作方式相同。
CommonMark 中完全缺少上述内容的是**表格**和**ID**(Markdown 块上的属性)。
好的,html 被从代码块中过滤掉了,代码块本身有点乱(它在栅格中)。:)
重点是,在打开标签后留空行,在关闭标签后留空行,并且 html 内部的 markdown 在 CommonMark 中有效。
你好,
我一直想知道如何创建一个简单的专用托管来显示 markdown,比如上传用 markdown 编写的文件,以便通过浏览器打开并查看格式化的文本?
干杯!
Daux.io 用于 php 文档,grav 用于 php md CMS,php-markdown 用于自行渲染。Markdown-it 和许多用于 node js 的库
最简单的答案是,如果您只想查看 markdown 作为格式化的文本,则 *不需要* 在线托管。
有一些方法可以避免此需求
使用 markdown 编辑应用程序
有许多专门为编写 markdown 而设计的应用程序,一些文本编辑器也有 markdown 预览插件。
运行一个本地服务器,它可以动态渲染 markdown
肯定有许多方法可以实现,一种方法可能是查找一个编译 markdown 的 nodejs 包,并编写一个小型服务器,当您请求 markdown 文件时,它会以 html 形式响应。
Atom 内置了 markdown 编辑/预览功能。
Sublime Text 有一些插件来支持它。
还有许多浏览器插件可以查看
.md
文件。只要您记得 Github markdown 和 markdown 是完全不同的东西
我认为对于您关于块元素(列表、引用块等)中换行符的问题,“官方”方法是在第一行末尾添加两个空格。花了一段时间才流行起来,但现在我一直在使用它。
你用
markdown="1"
就征服了我很棒的技巧集合!