---
title: 欢迎使用 Marqdo
description: 用户文档首页 — 代码即文档（中文版）
导入 数学:lib/数学.mq.md
导入 外联:lib/外联.mq.md
---

# main

阅读到这里的朋友你好！我是 Marqdo 的开发者。Marqdo 是一门*代码即文档，文档即代码*的语言：Markdown 标记就是程序结构，你读到的就是能跑的程序。

AI 偏爱 Markdown结构的输出。作者的念头是：何必再把文档和代码拆成两套？我们来实现一个文档即代码的语言，所以marqdo应运而生，为了确保代码一定可以被渲染，marqdo的文件后缀定义为了`.mq.md`。在开发之处我们就尝试希望更丰富的支持，自动生成一个yaml文件使得 OKF 式知识库便捷的自动配置，乃至自动生成ppt，自然这都是以后的目标了。不过相当不错的是，至少这会成为一个不错的博客工具——对，这个站点就是 Marqdo 生成的，而且AI输出的时候会节约不少token，你知道的，token烧的太多，钱包会可怜的饿瘦的。

语言仍在起步：结构标记、中英内核双名（`打印` / `print` …）、可导入的标准库（见本站 [`stdlib/`](stdlib/)）、本地 `view` 与静态导出。欢迎到 [GitHub](https://github.com/cflmy/marqdo) 一起做。

## 安装

解释器（CLI）任选其一：

| 方式 | 说明 |
|------|------|
| Ubuntu PPA | `sudo add-apt-repository ppa:cflmy/marqdo` 后 `sudo apt install marqdo` |
| GitHub Releases | [releases](https://github.com/cflmy/marqdo/releases) 下载 Windows / Linux 预编译包 |
| 源码 | `cargo build --release`（需本机 Rust） |

官方扩展与 CLI 可分开更新。安装扩展：

```text
marqdo ext add web
marqdo ext add quantum
```

`ext add` 下载顺序：CDN https://ext.marqdo.com → GitHub → proxy 镜像。详见本站 [`features/05-扩展.mq.md`](features/05-扩展.mq.md)。

English docs: [`00-welcome.mq.md`](00-welcome.mq.md) (English prose and English builtins).

用一个小函数打个招呼：

> 问候 谁=marqdo

具名实参可以带空格：

> 问候 谁=marqdo user

## 问候
    + `谁`

> 打印 内容=欢迎，`谁`！

*None*

除了上面的一些基本内容之外，我还开发了这个语言的一些标准库，包括表、时间、文本、文件、系统、数学和外联等标准库。

其中数学库和外联库是我要着重提到的，例如数学库，你可以通过下面的方式调用：

`f` =
$$
x^2 - 2
$$

之后让我们画个图像吧！

**`_svg` = > 数学.绘图 formula=`f` var="x" min=-3 max=3**

外联库则允许你调用外部代码，例如：

`hi` =
```python
print("hello-from-python")
```

这些代码在markdown下面都非常的易读，就像我说的，marqdo的设计思想就是代码即文档，
文档即代码。

最后，再次欢迎你，尽情体验marqdo吧！