# @edv4h/usketch-plugin-markdown-to-shape 中文文档

规范地址：https://npmcn.com/package/%40edv4h/usketch-plugin-markdown-to-shape/

版本：0\.2\.16
npm 元数据更新时间：2026-11-10T02:54:50.389Z
中文译文更新时间：2026-11-14T03:43:28.810Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40edv4h/usketch-plugin-markdown-to-shape
原文对照：https://npmcn.com/package/%40edv4h/usketch-plugin-markdown-to-shape/?lang=original
项目主页：https://github.com/EdV4H/usketch#readme
源码仓库：https://github.com/EdV4H/usketch

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：69.4 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-07-17T08:40:11.182Z
- 最新版本发布：2026-11-10T02:54:50.059Z
- 近 30 天下载量：2366（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @edv4h/usketch-plugin-markdown-to-shape
```

也可以使用：`pnpm add @edv4h/usketch-plugin-markdown-to-shape`、`yarn add @edv4h/usketch-plugin-markdown-to-shape`、`bun add @edv4h/usketch-plugin-markdown-to-shape`

## README

# @ edv4h/ usketch- plugin- markdown- 从形状

马克下..**原生形状**马克倒下 形状**変換レジストリに登録**\* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*。

## 仕組み

1.  `ctx.markdownConverters`(单位:千美元)`@edv4h/usketch-core` が提供、`PluginContext` 経由,に **转换器** を登録する:
    
    ```ts
    ctx.markdownConverters.register({
      id: "app:heading-to-text",
      nodeTypes: ["heading"],        // mdast のノード種別
      order: 0,                       // 高いほど優先、同点は後勝ち
      convert: (node, cctx) => [{ type: "text", text: /* ... */, fontSize: 28 }],
    });
    ```
    
2.  控制HUD=行动 **马克倒下**(马克倒地形状 qq) :
    -   `remark-parse + remark-gfm` 来源 **目标数** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢。
    -   顶级 qq 转换器 qq ()`nodeTypes`编号 :`match` → `order` □ □ □ □ □ □。
    -   **未登録のブロックは `markdown` 形状**(切片 美人鱼)。
    -   ++ 形状 ++ 标记下形状 ++ (**1=================================================================================================================================================================================================**) —— i —— (中文(简体) )。

## 依存の向き(デカップリング)

-   このプラグインは `@edv4h/usketch-shared` のみに依存し、**文本 / 表 {}形状 {} 导入}{}**键。
-   \\( : apps/web \\ 适配器\\ 标题\\ text \\ )\\ 代码/表\\ 原生形状\\ \\ **转换器qq**で、本体は無改変。
-   フォールバックの `markdown` 形状**型文字列だけ**{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢。

## 美人鱼

`mermaid` の `graph` 编号 : `flowchart`(TD/LR =) **矩形+文本 qq** 页:1 **连接器** qq 转换器qq ()`createMermaidFlowchartConverter`) 调用 \[1\] 适配器。

-   页:1 `@dagrejs/dagre` 页:1**国家** qq转换器 。
-   `ctx.origin` 连接器 = 节点 = id ==。
-   4.4 流程图 \* 美人鱼(序列/甘特 等) \* \* \* **缩放形状qq**(図としてそのまま描画)一。
-   页:1。

「1 ブロック`MarkdownShapeSpec` 有问题吗 `id`编号 :`x`编号 :`y` を、`MarkdownConverterContext` 有问题吗 `origin` spec (見出し等) 翻译 :。

## エクスポート

-   `createMarkdownToShapePlugin()` . . . . . 。
-   `createMermaidFlowchartConverter()` —美人鱼流程图 — — 转换器( app q)。
-   `parseFlowchart(code)` ——美人鱼流图qq(純粋関数)。
-   `convertMarkdownToShapes(opts)` \* 来源 \* \* `ShapeData[]`(オーケストレータ)一。
-   `parseMarkdown` 编号 : `topLevelBlocks` 编号 : `mdastText` 编号 : `nodeSource` - 转换器 実装用の mdast ヘルパ。

## 非スコープ/今後

-   v1(描画前は未確定). 度量衡。
-   代码 / 表 の 原生形状 が無いため当面は mark (設計どおり) 。 (設計どおり) 。 (。) 。 (。) 。 (。)。
-   qq( dvd = 1 文本)。

## 常见问题

### 如何安装 @edv4h/usketch-plugin-markdown-to-shape？

在项目目录运行 npm install @edv4h/usketch-plugin-markdown-to-shape，或使用 pnpm add / yarn add / bun add。

### @edv4h/usketch-plugin-markdown-to-shape 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @edv4h/usketch-plugin-markdown-to-shape 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @edv4h/usketch-plugin-markdown-to-shape 可以商用吗？

@edv4h/usketch-plugin-markdown-to-shape 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @edv4h/usketch-plugin-markdown-to-shape 的下载量有多少？

根据 npm 官方下载统计，@edv4h/usketch-plugin-markdown-to-shape 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,366 次，日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @edv4h/usketch-plugin-markdown-to-shape 还在维护吗？

最新版本 0\.2\.16 发布于 2026/11/10（4 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/07/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。