- UID
- 18
- 注册
- 2017/10/06
- 消息
- 87
- 解决方案
- 3
- 黄金
- 10,653G
Markdown是什么?
Markdown是一种轻量级标记语言。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用markdown来撰写帮助文档或是用于论坛上发表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。
相较于BBCode和直接的html标签,markdown是一种更简易更便捷的纯文本标记语言,可以让用户更专注于内容的编写而不是排版。
我为什么需要Markdown?
因为MineBBS的主要用户群体是开发者,他们一般都会使用github,因此也养成了markdown的编写习惯,所以xenforo上自带的可视化编辑器和BBCode编辑器并不能很好的满足他们的编写需求。也方便他们进行文档描述的搬运,而不需要重新排版。而Xenforo自带的markdown转换又是一个残次品,故产生了这个项目。
我们不提倡普通的社区使用该功能,因为大多数用户并不具备markdown的编写习惯和技巧。也没有必要性。
与站长的项目有何区别?
站长正在研究的,是将编辑器中的“代码编辑”从BBCode更换成Markdown,更彻底、可回退:https://www.cnxfans.com/threads/1624/
而我们的方式则是直接识别一个BBCode标签并将其内部的Markdown内容进行转换,不影响任何原编辑器的功能和此前输入的任何内容,就像是给一段文本加上一个加粗一样简单,但是如果转换服务失效,[MD]标签中的内容都会显示为普通文本,所以需要保持本服务有效。当然,还有一个优点,不要钱)
怎么实现?
本教程基于MineBBS管理团队@Subilan研究实现,利用Showdown的转换库实现外部转换
Github链接:https://github.com/McShare/xenforo-markdown
MineBBS公告:https://www.minebbs.com/threads/markdown.7586/
废话有点多,开始实操 ↓
实操教程:
至此,脚本将自动加载并识别转换文本中[MD][/MD]标签内的markdown标记
如果有任何建议和问题,都欢迎去Github提issue,本贴也可以回答和提一些简单的问题
注:请确保网站有jquery,使用之前也请仔细阅读github的readme文件
Markdown是一种轻量级标记语言。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用markdown来撰写帮助文档或是用于论坛上发表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。
相较于BBCode和直接的html标签,markdown是一种更简易更便捷的纯文本标记语言,可以让用户更专注于内容的编写而不是排版。
我为什么需要Markdown?
因为MineBBS的主要用户群体是开发者,他们一般都会使用github,因此也养成了markdown的编写习惯,所以xenforo上自带的可视化编辑器和BBCode编辑器并不能很好的满足他们的编写需求。也方便他们进行文档描述的搬运,而不需要重新排版。而Xenforo自带的markdown转换又是一个残次品,故产生了这个项目。
我们不提倡普通的社区使用该功能,因为大多数用户并不具备markdown的编写习惯和技巧。也没有必要性。
与站长的项目有何区别?
站长正在研究的,是将编辑器中的“代码编辑”从BBCode更换成Markdown,更彻底、可回退:https://www.cnxfans.com/threads/1624/
而我们的方式则是直接识别一个BBCode标签并将其内部的Markdown内容进行转换,不影响任何原编辑器的功能和此前输入的任何内容,就像是给一段文本加上一个加粗一样简单,但是如果转换服务失效,[MD]标签中的内容都会显示为普通文本,所以需要保持本服务有效。当然,还有一个优点,不要钱)
怎么实现?
本教程基于MineBBS管理团队@Subilan研究实现,利用Showdown的转换库实现外部转换
Github链接:https://github.com/McShare/xenforo-markdown
MineBBS公告:https://www.minebbs.com/threads/markdown.7586/
废话有点多,开始实操 ↓
实操教程:
至此,脚本将自动加载并识别转换文本中[MD][/MD]标签内的markdown标记
如果有任何建议和问题,都欢迎去Github提issue,本贴也可以回答和提一些简单的问题
注:请确保网站有jquery,使用之前也请仔细阅读github的readme文件
最后编辑: