Markdown / HTML 内容块

Markdown / HTML 内容块

15,304
12,439

为默认富文本编辑器提供编写 Markdown / HTML 的内容块扩展

下载

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索Markdown / HTML 内容块并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

默认富文本编辑器的 Markdown / HTML 内容块扩展

本插件是 Halo 默认富文本编辑器的扩展插件,允许你在默认编辑器中插入 HTMLMarkdown 块,用于撰写 HTML 或 Markdown 代码。

预览

HTML 编辑块

HTML Editor

Markdown 编辑块

Markdown edit block

用法

  1. Halo 中安装此插件并启用

  2. 在编辑器中点击 + 按钮,或者使用 / 快捷键, 选择 HTMLMarkdown 编辑块

    Insert edit block

  3. HTMLMarkdown 编辑块中编写代码

  4. 点击 保存 按钮,即可在文章中看到效果

开发

  1. fork 此仓库

    https://github.com/halo-sigs/plugin-hybrid-edit-block/fork
    
  2. 克隆自己的分支到本地

    git clone https://github.com/{you-name}/plugin-hybrid-edit-block
    
  3. 安装依赖

    cd path/to/plugin-hybrid-edit-block/console 
    
    pnpm install
    
    pnpm dev
    
  4. 打包最终产物

    ./gradlew clean build
    

常见问题

1. 是否支持 `style` 及 `script` 标签?

支持。但建议编写时将作用范围限制在较小范围内。

2. Markdown 编辑块中的回显内容与编写时的语法不一致?

由于 Markdown 编辑器最终产物是 HTML,因此回显的内容是基于 HTML 根据规则反解析的,因此可能与编写时的语法不一致。例如

* First item
* Second item
* Third item
* Fourth item

回显之后将会变成

- First item
- Second item
- Third item
- Fourth item
3. 停止使用此插件之后,之前编辑的内容会丢失吗?

之前编辑的内容不会丢失,但由于没有了插件支持,将无法正常显示。

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索Markdown / HTML 内容块并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

这是一个开源应用,我们推荐优先在开源仓库中提交 issue,以便开发者更好地接收和跟进问题。

去提交 issue