@adapttive/vue-markdown

中文文档
4.0.2发布于 2022/08/28MITTypeScriptCommonJS近 30 天下载 8209

用于 Vue 的强大和高速度标记

中文使用文档
文档目录6 节
  1. 浏览器全局
  2. 国家预防机制
  3. 雅伦
  4. 从vue-markdown 2.3 移动
  5. 常见JS
  6. ES6 (Vue-CLI 用户)

标记

npm npm npm npm npm

如果你想要Vue标记 vue1.X.X请退房 vue- markdown1. X.X。 。 。 .

威力和高速的Markdown Parser为Vue服务.

快速开始 : <vue-markdown>i am a ~~tast~~ **test**.</vue-markdown>

支持的马克下语法 :

  • 自动目录
  • 表格类自定义( c)
  • *语法高亮
  • 定义列表
  • 击穿
  • GFM 任务列表
  • 缩略语
  • 上标
  • 下标
  • 脚注
  • 插入
  • 爱莫吉
  • 标记
  • *卡特克语

*SyntaxHighlighter 与 棱镜 建议

*katex 需要添加 katex 密码。 。 。 .

示例

简单

网包简单

现场直播

安装

浏览器全局

这个 数字 文件夹包含 vue-markdown.js 中导出组件 window.VueMarkdown 对象.

<body>
  <vue-markdown>i am a ~~tast~~ **test**.</vue-markdown>
</body>
<script src="path/to/vue.js"></script>
<script src="path/to/vue-markdown.js"></script>
<script>
    Vue.use(VueMarkdown);
    var vm = new Vue({
        el: "body"
    });
</script>

国家预防机制

$ npm install --save @adapttive/vue-markdown

雅伦

$ yarn add @adapttive/vue-markdown --save

从vue-markdown 2.3 移动

  • 你只需要替换依赖性 package.json数字 :
{
  "dependencies": {
-  "vue-markdown": "^2.2.4
+  "vue-markdown": "npm:@adapttive/vue-markdown@^X.X.X"
  }
}

常见JS

var VueMarkdown = require('@adapttive/vue-markdown');

new Vue({
  components: {
    'vue-markdown': VueMarkdown
  }
})

ES6 (Vue-CLI 用户)

在通过Yarn或国家防范机制安装之后,请在您想要制作Markdown的Vue组件的脚本部分使用以下片段.

import VueMarkdown from '@adapttive/vue-markdown'

new Vue({
  components: {
    VueMarkdown
  }
})

槽数

<vue-markdown>this is the default slot</vue-markdown>

在您上面的 vue 组件中设置了中间软件后, 使用嵌入式的标记下, 和在中间写入一样容易 vue-markdown 标签.

VueMarkdown 有一个默认槽,用于写入 markdown 来源.

TIP: 默认槽仅使 一次 在开始, 它会覆盖道具 source来啊!

道具

Prop类型默认说明
手表阵列["source", "show", "toc"]当此数组中的道具改变时 HTML 自动刷新
来源字符串null标记下源代码
显示布尔true启用自动渲染到默认位置
(简体中文)布尔true启用源代码中的 HTML 语法
xhtml 输出布尔true<br></br> => <br />
间断布尔true\n => <br>
链接布尔true自动转换类似 URL 的文本以链接
爱莫吉布尔true:) => 😃
打字员布尔true允许一些语言中性替换和引用美化
更新棱镜布尔true如果为真, vue- markdown 将自动通过 Prism.js 调用所有代码块的重排(使用棱镜.js(中文(简体) )
朗语前缀字符串language-栅栏区块的 CSS 语言前缀
引用字符串“”‘’使用情况 “”‘’ 对于中文, „“‚‘ 德语, «»„“ 俄语
表格类字符串table自定义 html 类 <table>
任务列表布尔true让GFM任务列表可变, false gFM 显示为只读的复选框
目标c布尔false启用自动目录
目标编号字符串undefined要渲染 TOC 的 HTML ID
toc 类字符串table自定义 html 类 <ul> 包装 TOC
一级数目2使用情况 2 如果你想跳过 <h1> 从技选中心
最后一级数目'toc-first-level' + 1使用情况 5 如果你想跳过 <h6> 从技选中心
托克-锁定链接布尔true启用标题中的自动锁定链接
托克-锁定级字符串toc-anchor自定义锚类名称
toc-anchor-link-同义词字符串#自定义锁定链接符号
托克-锁定-链接-空间布尔true允许在锁定链接和标题之间插入空格
toc-anchor-link-class 分类字符串toc-anchor-link自定义锁定链接符号类名
托克-锁定-链接-前布尔true允许您在标题中预置/追加主机链接
锁定属性对象{}锁定标签属性, 如 target: '_blank' 或者说 rel: 'nofollow'
放弃函数 (字符串) 字符串null在下标解析前过滤功能
离职后函数 (字符串) 字符串null标出后过滤功能
内入布尔false结果将不会被包入 <p> 标记

活动

名称参数 [类型]说明
已执行出Httml [结完成时发送
已移交tocHtml [结当 TOC 完成时发送, 如果toc[道具] 是则永远不要发送 false

使用棱镜.js

  1. 访问 下载页面
  2. 选择您项目的所有选项
  3. 在页面底部下载JS和CSS
  4. 把它们包含在您的 index.html 确定在您之前包含棱镜 app.js

插件

 <template>
   <div>
     <vue3-markdown-it :source='source' :plugins='plugins' />
   </div>
 </template>

 <script>
 import katex from 'markdown-it-katex';
 import tasklists from 'markdown-it-task-lists';
 import externalPreview from 'markdown-it-external-preview';
 import VueMarkdown from 'vue-markdown';

 export default {
   components: {
     VueMarkdown
   },
   data() {
     return {
       plugins: [
         {
           plugin: katex,
           options: { throwOnError: false, errorColor: ' #cc0000' }
         },
         {
           plugin: tasklists,
           options: { enabled: this.taskLists }
         },
         {
           plugin: externalPreview
         }
       ]
     }
   }
 }
 </script>
  • 确保您添加插件的依赖性 :
    • "highlight.js": "^10.4.0"
    • "markdown-it-external-preview": "^1.0.4"
    • "markdown-it-katex": "npm:@iktakahiro/markdown-it-katex@^4.0.1"

谢谢

捐款

许可证

版权(c)2016年

版本与发布记录

@adapttive/vue-markdown 共发布 20 个版本,首次发布于 2020/12/19;过去 12 个月发布了 0 个版本。

版本发布日期距今
4.0.2latest2022/08/284 年前
4.0.12021/03/075 年前
4.0.0alpha2021/02/165 年前
3.0.32020/12/265 年前
3.0.22020/12/265 年前
3.0.12020/12/265 年前

其他发布通道:beta → 3.0.0-beta.2,alpha → 4.0.0。

关于 @adapttive/vue-markdown 的常见问题

@adapttive/vue-markdown 是什么?

用于 Vue 的强大和高速度标记

如何安装 @adapttive/vue-markdown?

在项目目录运行 npm install @adapttive/vue-markdown,或使用 pnpm add / yarn add / bun add。

@adapttive/vue-markdown 支持 TypeScript 吗?

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

@adapttive/vue-markdown 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@adapttive/vue-markdown 可以商用吗?

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

@adapttive/vue-markdown 的下载量有多少?

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

@adapttive/vue-markdown 还在维护吗?

最新版本 4.0.2 发布于 2022/08/28(4 年前);至今共发布 20 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/12/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。