Markdown 功能演示

本站在 Python-Markdown 基础上扩展了脚注、语义颜色、目录生成等功能。下面逐一演示。

文字样式

粗体、斜体、删除线、行内代码，也可以组合：粗体中的斜体和 代码。

颜色用语义类名，构建时自动替换为当前主题色：强调文字（c-accent）、高亮文字（c-highlight）、代码色（c-code）、次要文字（c-dim）、粉色文字（c-pink）、绿色文字（c-green）。

也可以用 font 标签直写颜色（正常模式保留，阅读版会被剥离）：粉色 / 青色

标题层级

上面已经看到了一级和二级标题。下面是三级到六级：

链接与图片

• 外部链接：GitHub
• 站内链接：文章归档
• 锚点链接：跳转到总结

图片支持 alt 文字和 title：

代码块

行内代码用反引号包裹。多行代码用围栏语法，指定语言可以获得语法高亮：

#!/usr/bin/env python3
"""一个简单的 HTTP 服务器示例"""
import http.server
import socketserver
PORT = 8080
class MyHandler(http.server.SimpleHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.end_headers()
        self.wfile.write(b"Hello, 90s Web!")
with socketserver.TCPServer(("", PORT), MyHandler) as httpd:
    print(f"Serving on port {PORT}")
    httpd.serve_forever()

<table width="100%" border="1" bordercolor="#ff66cc">
  <tr><td>Hello</td><td>World</td></tr>
</table>

无语言标注的代码块：

$ python scripts/web_server.py nolog nocount
DragonRSTER`s Void v5.1 - port 81

列表

• 第一项
• 第二项，内容较长时会自动换行，不会超出 700px 列宽。这里多写几个字测试一下换行效果,这里多写几个字测试一下换行效果。
• 第三项

1. 第一步：打开终端
2. 第二步：输入命令
3. 第三步：按下回车

引用块

这是一个引用块。SMR 磁盘不应该用于频繁写入删除的场景。从原理上这会造成数据搬运，导致性能下降甚至卡死。 引用块内可以加粗、斜体，也可以包含代码。 多段引用只需要每段前面加 >。
嵌套引用：

二层引用，现在看看效果

三层引用

表格

表格内的文字也支持加粗和代码。

分割线

上面的分割线用 --- 实现：

分割线下面继续写内容。

脚注

本站实现了 Markdown 脚注系统^[1]。脚注会自动收集到文末，生成双向链接^[2]。

脚注链接点击可跳转，脚注末尾也有回链。

目录生成

在文章顶部的 HTML 注释中指定 <!-- toc:自定义目录 --> 可以手动控制目录内容。本站就是使用这种方式生成侧栏目录。

如果不写 <!-- toc: --> 注释，构建时自动从二级标题提取生成目录。

总结

这篇文章覆盖了本站 Markdown 引擎的全部功能：