就在前几天，我在这个BBS上，找遍了每一个角落，
但找不到任何Markdown帮助按钮来解释格式规则。
不，我不是在问规则是什么。
我也不在要链接。
我是说你们需要在人们发帖时，就在编辑框旁边提供一个链接，
让他们知道如何格式化。
好吧，也许任何文档还没有准备好供普通用户使用，
2 个赞
作曲家工具栏提供了格式化文本的选项，可以为您格式化文本，并向您展示如果您想手动添加 Markdown [1] 的效果。这是否比一个会将您带到消息之外的文档链接更有帮助？
以及一些 BBCode，具体取决于您添加的内容 ↩︎
2 个赞
是的。以想要说“
而不是
”的用户为例。
嗯，最终他会发现正确的方法，使其看起来像“
https://www.openstreetmap.org/，而不是
https://www.openstreetmap.org/edit
”。
但如果他不是自己去弄清楚，他绝对不可能弄明白，因为在编辑器里，这是一个巨大的谜团，没有任何文档。零。
2 个赞
你使用用户的方式很有趣，每次你指的是“我”。只是说一下。
在网络上有三种不同的内容创建编辑器：
- CMS 风格，如 WordPress、Drupal 等，有很多按钮（嗯，WordPress 正在尽一切努力破坏他们的编辑器，但那是另一回事）
- 极简的社交媒体，如 Facebook、Twitter 等，没有按钮或只有几个
- 古老的开发世界，主要是静态网站生成器等，以及 Discourse
第一组试图使用我们早在网络之前就在办公软件中学到的逻辑。没有真正的帮助按钮，因为每个人都应该知道按钮的作用。或者快捷键是什么。如果用户不知道，他/她/它必须找到那条信息。
社交媒体已经意识到，普通人不需要那些按钮，因为他们不使用它们——而且在手机上根本没有空间。也没有帮助按钮，因为没有必要。
基于开发的编辑器为那些知道如何标记内容而无需看到它发生、记住一堆代码并且不想将手从键盘上移开的人提供服务。也没有帮助按钮，因为每个人都应该阅读文档并记住如何制作表格，例如。
但用户是不同的。在我的论坛上，普通人谈论普通的事情，他们的技术技能大多较低。这里在 Dev 或 GitHub 上有完全不同的需求，并且假设每个人都拥有非常高的技能。此外，创建的内容也完全不同。我是一个网站的成员，该网站以写作本身为重点。那里又有完全不同的需求。
用户体验问题不在于工具箱中的帮助按钮。没有人使用它，因为它不可能创建和使用。即使是 GitHub 风格的链接也太多了。它是一个完全不相关的组件，很少被使用，而且每个人都知道那里有文档和手册。
真正的用户体验/用户界面解决方案是让
- 管理员为用户创建默认设置
- 允许用户更改默认设置
而大多数用户实际需要并且现在缺失的是一种隐藏该工具栏的方法。这比编辑它的能力更重要。
编辑器的问题几乎是这里的常见问题，而帮助按钮只是其中的一部分。让我们再次直说。Dan 有他自己的议程，帮助按钮只是他议程的另一个标志，而不是目标。我希望 Dan 实际上是在说他不知道如何做某事并且找不到帮助。这应该是那个网站的问题，而不是 Discourse 本身作为一个平台的问题。
2 个赞
是的，我说的就是我发帖时遇到的实际情况
而且两个链接预览是相同的，让我的帖子看起来很傻。
所以我一直在与（Discourse）界面斗争，试图找到一种方法来禁用
所有这些魔法——但没有关于如何做的文档。
所以一切都只能是反复试验……
然后我尝试了
https://www.openstreetmap.org/ .
https://www.openstreetmap.org/edit .
这会产生奇怪的组合
https://www.openstreetmap.org/ .
OpenStreetMap .
这确实有它的逻辑，但这不是我的重点。
它仍然不是我想要的帖子给别人的样子。
这时我心想：“我还是看看官方文档吧，而不是花费数小时反复试验。”
好的，我看了又看，找到了 Formatting posts using markdown, BBCode, and HTML 。
好的，它提到了
[url]http://bettercallsaul.com[/url]
格式，但是用
[url]https://www.openstreetmap.org/[/url]
[url]https://www.openstreetmap.org/edit[/url]
有些东西不起作用：
https://www.openstreetmap.org/
https://www.openstreetmap.org/edit
因此 Formatting posts using markdown, BBCode, and HTML 可能已经过时了，等等。
那么我最终是如何解决我的问题的，使用
[https://www.openstreetmap.org/](https://www.openstreetmap.org/), not
[https://www.openstreetmap.org/edit](https://www.openstreetmap.org/edit)
得到
https://www.openstreetmap.org/, not
https://www.openstreetmap.org/edit
嗯，我记得你们使用“Markdown”，我记得 Markdown 有那种语法，
而且它起作用了。
我
要
说
的
是
应该有一个官方文档，告诉用户输入这个和那个字符时会发生什么。
他们不应该为了找出答案而阅读源代码。谢谢。
好吧，把它放在 FAQ 里，然后把 FAQ 链接到界面上的某个地方。
好的，假设你把未来的格式 FAQ 放在 Discourse 网站上。问题解决了……
除了用户怎么知道他正在使用 Discourse？是的，我说的是用户，不是管理员。再次感谢。
2 个赞
Just as an FYI, but there’s this button in the composer that can help out:
If you put the URL in the top box, and the display text in the bottom it will format it in the markdown for you. 
5 个赞
这是一个稻草人。也许有一些硬核的乐于助人的开发者能够记住格式规则而无需文档，但并非所有非初学者都能记住所有格式规则。
由于 Discourse 的不同实例支持不同风格的 Markdown、BBCode 和 HTML，因此文档中没有这样的手册。
如果有人为特定网站上有效的标记代码集构建了手册，并想在编辑器页面上放置一个类似 GitHub 的帮助链接，如下所示，该如何实现？
我看到这个存在：
2 个赞