• 兼容 Vue
    • 基础用法
    • 搭配 Vuep 写 Playground

    兼容 Vue

    你可以直接在 Markdown 文件里写 Vue 代码,它将被执行。我们可以用它写一些 Vue 的 Demo 或者示例代码。

    基础用法

    index.html 里引入 Vue。

    1. <script src="//unpkg.com/vue"></script>
    2. <script src="//unpkg.com/docsify"></script>

    接着就可以愉快地在 Markdown 里写 Vue 了。默认会执行 new Vue({ el: '#main' }) 创建示例。

    README.md

    1. # Vue 介绍
    2. `v-for` 的用法
    3. ```html
    4. <ul>
    5. <li v-for="i in 10">{{ i }}</li>
    6. </ul>
    7. ``
    8. <ul>
    9. <li v-for="i in 10">{{ i }}</li>
    10. </ul>

    当然你也可以手动初始化 Vue,这样你可以自定义一些配置。

    README.md

    1. # Vue 的基本用法
    2. <div>hello {{ msg }}</div>
    3. <script>
    4. new Vue({
    5. el: '#main',
    6. data: { msg: 'Vue' }
    7. })
    8. </script>

    !> 一个 Markdown 文件里只有第一个 script 标签内的内容会被执行。

    搭配 Vuep 写 Playground

    Vuep 是一个提供在线编辑和预览效果的 Vue 组件,搭配 docsify 可以直接在文档里写 Vue 的示例代码,支持 Vue component spec 和 JSX。

    index.html

    1. <!-- inject css file -->
    2. <link rel="stylesheet" href="//unpkg.com/vuep/dist/vuep.css">
    3. <!-- inject javascript file -->
    4. <script src="//unpkg.com/vue"></script>
    5. <script src="//unpkg.com/vuep"></script>
    6. <script src="//unpkg.com/docsify"></script>
    7. <!-- or use the compressed files -->
    8. <script src="//unpkg.com/vue/dist/vue.min.js"></script>
    9. <script src="//unpkg.com/vuep/dist/vuep.min.js"></script>
    10. <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>

    README.md

    1. # Vuep 使用
    2. <vuep template="#example"></vuep>
    3. <script v-pre type="text/x-template" id="example">
    4. <template>
    5. <div>Hello, {{ name }}!</div>
    6. </template>
    7. <script>
    8. module.exports = {
    9. data: function () {
    10. return { name: 'Vue' }
    11. }
    12. }
    13. </script>
    14. </script>

    ?> 具体效果参考 Vuep 文档。