Markdown格式帮助

Markdown是一种设置文字样式与插入图片的方法，能用于Habitica的以下区域：

• 任务和奖励（包括挑战和团队计划中的任务和奖励）的标题、注释及任务下的清单
• 公会、队伍或挑战的标题、概要和详细描述
• 公会、队伍或酒馆的聊天功能
• 私信
• 角色信息中的介绍文字

用Markdown插入的图片可以上传到任何网站。（如果不使用Markdown，也可以使用Emoji来插入小型图片，但可选的图片有限。）

注意，在移动客户端中，Markdown显示的实际效果（如下表所示）可能与预期效果相差甚远。

请不要在Habitica中使用故障风的文字（Glitch Text）。大多数情况下，这样的文字无法正常显示出来，同时，也无法被翻译软件或屏幕朗读器正常识别。

想了解更多用Markdown进一步改善Habitica使用体验的内容，请查看Markdown使用案例聚焦页面。

Markdown示例

链接、图片和Emoji

看到的效果	输入的内容	备注
Habitica	[超链接](网站地址放在这里) 例如： [Habitica](https://habitica.com)	请注意，方括号和圆括号之间没有空格。
	 例如： 	替代文本，是指图片因网速太慢或网址错误等原因无法显示，或者是使用屏幕朗读器时，替代图片显示的文字。替代文本必须要输入。[需要验证]同时，图片网址也应当输入完整（图片大小会被调整）。
	:smiley:	emoji备忘录和emoji大全中有成百上千的Emoji表情符号，如果代码不起作用，你还可以用操作系统自带的字符查看器（MacOS、Windows和Linux系统）插入emoji。

其他Markdown

如下表所示，在文本前加上一个或多个“#”（井号），可以形成不同级别的标题。在Markdown中，有6个标题级别（H1至H6）；加上6个井号会显示最小号的标题。井号必须放在一行的开头，同时，井号和标题文本之间必须空一格。否则，这些井号将会直接显示出来，而标题文本的字号也不会改变。除非特别需要，否则应当尽量避免聊天时使用大字号的标题，因为这样会占用大量的空间。

看到的效果	输入的内容	备注
标题1	# 标题1	请参阅上方关于标题的说明。
标题2	## 标题2
标题 3	### 标题3
斜体文字	*斜体文字* _斜体文字_	可以用“_”代替“*”
加粗文字	**加粗文字**
带删除线的文字	~~带删除线的文字~~
斜体加粗文字	***斜体加粗文字***
_非斜体_ # 非标题 **非粗体**	\_非斜体\_ \# 非标题 \*\*非粗体\*\*	需要输入一个Markdown中用于标记的符号，但又希望这个符号能直接显示出来时，就需要在每个用于标记的符号前加一个反斜杠“\”。
	`代码`	键盘上没有反引号“`”的国际用户，可以在按住ALT键时输入“96”来插入反引号。
	>被引用的文本	可以使用多个尖括号“>”，再次引用被引用的文本。
	在“这是一般的文本。”后按下Enter键或Shift键+Enter键两次来另起一个新的段落。在“这是突出显示的段落。”前空四格。	这样就能突出显示一个段落。
	在新的一行开头输入三个反引号（```），然后就可以在接下来的几行中输入文本或代码。要结束这个代码块，另起一行，然后再输入三个反引号（```）即可。 较长的段落并不会自动换行。要想得到左侧图片中换行的效果，需要手动插入换行符。 按下Enter键或Shift键+Enter键会插入一个换行符。 按下Enter键或Shift键+Enter键两次会插入一个空行。 不同于上方突出显示文本的方法，这个方法不需要在每段开头都空四格。	Markdown代码块会显示为无格式文本，通常用于展示软件代码。 键盘上没有反引号“`”的国际用户，可以在按住ALT键时输入“96”来插入反引号。
一行文本 下方的另一行文本	在上一行文本的末尾输入两个空格，然后按下Enter键或Shift键+Enter键一次，就可以另起一行。	输入文本，输入两个空格，换行，再输入文本。
一行文本 下方的另一行文本，但两行之间有间距	按下Enter键或Shift键+Enter键两次，就会产生这种效果。在按下发送按钮前，你的文本应该看起来是这样的： 一行文本 下方的另一行文本，但两行之间有空行	输入文本，空一行，再输入文本。
手动    插空    文本	在某个字前插入多个“ ”，才可以在两个字之间显示多个空格。	便于任务标题的居中或位置调整。
• 无序（项目符号）列表	在新的一行开头输入“+”、“*”或“-”后，空一格再输入文本。	键盘上没有“+”（加号）的国际用户，可以在按住ALT键时输入“43”来插入加号。
1. 有序（编号）列表	在新的一行开头输入“1.”后，空一格再输入文本。
水平线	按下Enter键或Shift键+Enter键两次，输入三个连字符“---”，然后再按下Enter键或Shift键+Enter键两次来生成一条水平线。另一种办法是，按下Enter键或Shift键+Enter键一次， 输入三个下划线“___”，然后再按下Enter键或Shift键+Enter键一次。	输入文本，空一行，输入三个连字符“---”，空一行，再输入文本。或者，输入文本，换行，输入三个下划线“___”，换行，再输入文本。
表格 第一列标题 第二列标题 内容单元格  内容单元格 内容单元格  内容单元格	第一列标题|第二列标题 ---------|--------- 内容单元格|内容单元格 内容单元格|内容单元格	非常适合将标题与文本对齐。 尽管第二行只需要输入三个连字符“---”就够了，但即使输入多于三个的连字符也能正常显示。
– —	– —	Markdown支持使用HTML字符实体（HTML entity）。要使用，只需输入实体名称的字符串。字符串都以“&”（与号）开头，以“;”（英文分号）结尾。

Markdown问题的解决方法

Markdown非常有用，但有时预设的语法也会出问题。下表包含已知的问题和建议的解决方案。

看到的效果	想要的效果	解决方法	备注
1. 项目一 1. 项目二 1. 项目三	1. 项目一 2. 项目二 3. 项目三	1\. 项目一 2\. 项目二 3\. 项目三	Markdown会把以后接句点的数字为开头的一行当作编号的列表项。如果不希望Markdown错误地重新开始编号，那么在编号和句点之间插入反斜杠就可以解决这个问题。
此处~~“删除线效果”~~不能正常显示；此处*斜体效果？*不能正常显示；此处_！斜体效果_不能正常显示；此处**（加粗效果）**不能正常显示；此处***(加粗斜体效果)***不能正常显示。 由于此时所加的Markdown标记符号与标点符号相邻，Markdown标记符号将会直接显示出来。	此处 “删除线效果” 将能够正常显示；此处 斜体效果？ 将能够正常显示；此处 ！斜体效果 将能够正常显示；此处 （加粗效果） 将能够正常显示；此处 (加粗斜体效果) 将能够正常显示。 由于空格的存在，未加Markdown标记符号时标点符号不再和文字直接相邻了。	此处 ~~“删除线效果”~~ 将能够正常显示；此处*斜体效果？* 将能够正常显示；此处 _！斜体效果_ 将能够正常显示；此处 **（加粗效果）**将能够正常显示；此处 ***(加粗斜体效果)*** 将能够正常显示。 在Markdown标记符号与标记符号外的文字间空一格，使未加Markdown标记符号时标点符号不与文字直接相邻。	使用Markdown格式中的带删除线的文字、斜体文字、粗体文字、粗体且斜体的文字时，若所加的波浪号（“~~”）、星号（“*”/“**”/“***”）、下划线（“_”）这些Markdown标记符号与标点符号相邻时，Markdown的标记符号将会直接显示出来，而不会显示出Markdown效果。如果想给一整段话添上删除线、斜体或粗体效果，则不需要担心这一问题。上述的标点符号包括中文和英文的标点符号。

Markdown技巧

下表包含一些Markdown技巧，可以在任何支持Markdown的地方使用。

看到的效果	输入的内容	备注
		进度条可以嵌入Habitica中，用于显示每个习惯、每日任务、待办事项（甚至每个清单项目）或奖励的进度百分比，也可以在Habitica中其它支持Markdown的地方使用。 更多示例请查看GitHub上的项目页面。
数学公式与图形（LaTeX） 示例（点击放大）	 将“图片网址”替换为使用下面的方法生成的图像链接： 在QuickLaTeX（或TikZ）中输入数学公式的相应字符串，然后设置偏好。如果你不熟悉LaTeX语法，也可以尝试使用网上的可视化编辑器（如LaTeX公式编辑器或HostMath）创建一个字符串，然后将其复制到QuickLaTex的输入框中。 点击Render按钮。网站将生成一张服务器缓存的图片，并显示指向这张图片的链接。	这使用了Markdown中常见的插入图像的语法来插入数学公式和图形。 替代文本，是指图片因网速太慢或网址错误等原因无法显示，或者是使用屏幕朗读器时，替代图片显示的文字。替代文本必须要输入。[需要验证]同时，图片网址也应当输入完整（图片大小会被调整）。

另见

• Markdown官方语法指南（链接指向的不是wiki页面，而是Markdown创始人John Gruber的官方网站）
• 什么是Markdown？