前言
刚接到这个需求的时候,觉得很简单(的确很简单)但是这玩意的坑真的也让人无奈。
网上找了很多的资料,都没有写出痛点(这就很难过了)。通过实践并且在我们项目中平稳运行,想分享给后面的人
我的博客上也写了100多篇文章,点击量有上万的也有个位数的,能够帮助到他人这就是写作记录的动力。
需求
vue项目中可以良好展示markdown(只是展示功能 没有编辑功能)
痛点问题
- .md文件类型,直接模块加载(只有字符串,这得多难受,怎么维护呢),还是一个文件一个文件的好维护并且好修改复用
- 用第三方插件,只是md转HTML,不带样式的(重点强调 没有样式没有样式)
解决方案
一、vue需要有markdown这样良好的展示效果,什么样的插件是最好的?
货比三家,我推荐以下方式
//安装 npm install --save html-loader; npm install -- save markdown-loader; //webpack
{
test: /\.md$/,
loader: "html-loader",
},
{
test: /\.md$/,
loader: "markdown-loader"
}
大坑预警:我不知道在哪里抄的配置,一定不要配置option(配置了的话表格 代码 都不能好好转化)
以上真的就完成了转化了。是不是so easy !!! 再来换个皮肤(穿上衣服)
二、一定要引用CSS,找了很多样式真的都特别的丑(当然可以自己写,但是费时间啊)
强烈推荐
npm install github-markdown-css import 'github-markdown-css'; //哪里用markdown 就在哪里引用 可以放在min.js //自己也可以再调整调整 (贡献一版 我们调整的一版样式)
.markdown-body { padding: 20px; min-width: 200px; max-width: 900px; font-size: 12px; h2 { font-size: 18px; margin: 1em 0 15px; padding-top: 0.8em; padding-bottom: 0.8em; } h3 { font-size: 14px; margin: 22px 0 16px; } h4 { font-size: 13px; margin: 20px 0 16px; } h5 { font-size: 12px; margin: 16px 0 16px; font-weight: 700; } p { font-size: 12px; line-height: 24px; color: #666666; margin-top: 0px; margin: 8px 0; margin: 14px 0 14px; } pre { background-color: #eee; margin-bottom: 8px; margin-top: 8px; margin: 12px 0 12px; } blockquote { margin-bottom: 8px; margin-top: 8px; margin: 14px 0 14px; background-color: #eee; padding: 16px 16px; } tr { background-color: #f5f5f5; } code { background-color: #eee; } ul, ol, li { list-style: unset; font-size: 12px; line-height: 20px; color: #666666; margin-top: 0px; margin: 8px 0; } blockquote { border-color: #48b6e2; } table { display: table; width: 100%; max-width: 100%; margin-bottom: 20px; } }
三、页面运用(实践检验真理)
页面 <template> <div class="markdown-body" v-html="htmlMD"></div> //markdown-body 一定要写这个class名 </template> <script> export default { name: 'GitBook', data() { return { htmlMD: '' }; }, mounted() { this.getHtmlMD(this.$route.query.databaseType); }, methods: { getHtmlMD(type) { this.htmlMD = require(`./GitBook/${type.toLowerCase()}.md`); //导入md 我这里根据不同的类型拿不同md文件 } } }; </script>
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E5%A4%AA%E5%B9%B3%E6%B4%8B%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%96%B0%E5%8C%97%E5%B8%82%E7%A7%81%E7%AB%8B%E5%85%89%E5%8D%8E%E9%AB%98%E7%BA
%A7%E5%95%86%E4%B8%9A%E8%81%8C%E4%B8%9A%E8%BF%9B%E4%BF%AE%E5%AD%A6%E6%A0%A1%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC
%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E9%A6%99%E6%B8%AF%E5%B2%AD%E5%8D%97%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%B1%B3%E5%85%B0%E5%9B%BD%E7%AB%8B%E7%BE%8E%E6%9C%AF%E5%AD%A6%E9%99%A2%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%BE%B3%E9%97%A8%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC
%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=CISSP%E8%AF%81%E4%B9%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC
%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%BE%B7%E5%9B%BD%E4%BA%9A%E7%90%9B%E5%B7%A5%E4%B8%9A%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%96%B0%E5%A5%A5%E5%B0%94%E8%89%AF%E6%B4%9B%E7%BA%A6%E6%8B%89%E5%A4%A7%E5%AD
%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8D%97%E5%8D%A1%E7%BD%97%E6%9D%A5%E7%BA%B3%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8D%97%E5%8D%A1%E7%BD%97%E6%9D%A5%E7%BA%B3%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%BE%B7%E5%9B%BD%E9%A9%AC%E5%B0%94%E5%A0%A1%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E8%8B%B1%E5%9B%BD%E7%BA%A6%E5%85%8B%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%BC%97%E4%BC%A6%E6%96%AF%E5%A0%A1%E5%BA%94%E7%94%A8%E6%8A%80%E6%9C%AF
%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E8%8B%B1%E8%BF%AA%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC
%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%97%A5%E6%9C%AC%E6%98%8E%E6%B2%BB%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%96%B0%E5%8A%A0%E5%9D%A1%E4%B8%9C%E4%BA%9A%E7%AE%A1%E7%90%86%E5%AD
%A6%E9%99%A2%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E7%88%B1%E8%8D%B7%E5%8D%8E%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E8%8B%B1%E5%9B%BD%E8%A5%BF%E8%8B%B1%E6%A0%BC%E5%85%B0%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E5%87%AF%E6%96%AF%E8%A5%BF%E5%82%A8%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E8%AF%BA%E6%96%AF%E4%BC%8D%E5%BE%B7%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E8%8B%B1%E5%9B%BD%E8%82%AF%E7%89%B9%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8A%A0%E6%8B%BF%E5%A4%A7%E5%BA%B7%E8%80%83%E8%BF%AA%E4%BA%9A%E5%A4%A7%E5%AD
%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%88%A9%E7%89%A9%E6%B5%A6%E7%BA%A6%E7%BF%B0%E6%91%A9%E5%B0%94%E5%A4%A7%E5%AD
%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%BE%B7%E5%9B%BD%E6%B1%89%E5%A0%A1%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E9%9F%A9%E5%9B%BD%E6%AA%80%E5%9B%BD%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%9F%83%E5%BE%B7%E8%92%99%E5%85%B9%E7%A4%BE%E5%8C%BA%E5%AD%A6%E9%99%A2%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E5%A8%81%E6%96%AF%E5%BA%B7%E6%98%9F%E5%BA%B7%E8%80%83%E8%BF%AA
%E4%BA%9A%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E5%8A%A0%E5%B7%9E%E5%A4%A7%E5%AD
%A6%E6%97%A7%E9%87%91%E5%B1%B1%E5%88%86%E6%A0%A1%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E4%B8%9C%E5%AF%86%E6%AD%87%E6%A0%B9%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%9F%BA%E7%9D%A3%E5%9F%8E%E7%90%86%E5%B7%A5%E5%AD%A6%E9%99%A2%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%97%A5%E6%9C%AC%E4%B8%AD%E5%A4%AE%E5%AD%A6%E9%99%A2%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8A%A0%E6%8B%BF%E5%A4%A7%E7%BB%B4%E5%A4%9A%E5%88%A9%E4%BA%9A%E5%A4%A7%E5%AD
%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%97%A5%E6%9C%AC%E5%8D%83%E5%8F%B6%E7%A7%91%E5%AD%A6%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E9%A9%AC%E6%A0%BC%E5%BE%B7%E5%A0%A1%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E8%A5%BF%E6%97%A5%E6%9C%AC%E5%B7%A5%E4%B8%9A%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E9%9F%A9%E5%9B%BD%E5%A4%A7%E4%BD%9B%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF
%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E7%BE%8E%E5%9B%BD%E8%A5%BF%E4%BF%84%E5%8B%92%E5%86%88%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%99%AE%E6%B8%A1%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC
%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%96%B0%E5%8A%A0%E5%9D%A1%E5%85%B1%E5%92%8C%E7%90%86%E5%B7%A5%E5%AD
%A6%E9%99%A2%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8F%B0%E6%B9%BE%E5%9B%BD%E7%AB%8B%E6%94%BF%E6%B2%BB%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%96%B0%E8%A5%BF%E5%85%B0%E5%9D%8E%E7%89%B9%E4%BC%AF%E9%9B%B7%E5%A4%A7%E5%AD
%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%97%A5%E6%9C%AC%E6%B5%81%E9%80%9A%E7%BB%8F%E6%B5%8E%E5%A4%A7%E5%AD%A6%E6%AF
%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%9C%A3%E5%A1%94%E8%8E%AB%E5%B0%BC%E5%8D%A1%E5%AD%A6%E9%99%A2%E6%AF%95%E4%B8%9A
%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%85%B0%E6%96%AF%E9%AB%98%E7%AD%89%E5%B7%A5%E5%95%86%E7%AE%A1%E7%90%86%E5%AD
%A6%E9%99%A2%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%BE%B3%E5%A4%A7%E5%88%A9%E4%BA%9A%E5%9F%83%E8%BF%AA%E6%96%AF
%E7%A7%91%E6%96%87%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E9%9F%A9%E5%9B%BDTOPIK%E8%AF%81%E4%B9%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C
%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E5%8A%A0%E6%8B%BF%E5%A4%A7%E9%BA%A6%E5%85%8B%E9%A9%AC%E6%96%AF
%E7%89%B9%E5%A4%A7%E5%AD%A6%E6%AF%95%E4%B8%9A%E8%AF%81%E6%A0%B7%E6%9C%AC%E8%96%87%EF%BC%88aaqq2099%EF%BC%89
https://www.docin.com/search.do?searchcat=1001&nkey=%E6%97%A5%E6%9C%AC%E7%BB%8F%E6%B5%8E%E5%A4%A7%