- 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文件
最后编辑：
