Habitica Wiki
Advertisement
Habitica Wiki

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

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

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

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

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

Markdown示例

链接、图片和Emoji

你看到的效果 你输入的内容 备注
Habitica [超链接](网站地址放在这里)

例如:
[Habitica](https://habitica.com)

请注意,方括号和圆括号之间没有空格。
斑驳陆离的绿色药水装在一个塞着棕色瓶塞的药水瓶中.jpg
![描述图片内容的替代文本](图片URL地址 "鼠标悬停时显示的文本(可选)")

例如:
![斑驳陆离的绿色药水装在一个塞着棕色瓶塞的药水瓶中.jpg](https://example.com/example_image_name.png "僵尸孵化药水")

替代文本,是指图片因网速太慢或网址错误等原因无法显示,或者是使用屏幕朗读器时,替代图片显示的文字。替代文本必须要输入。[需要信息]同时,图片URL地址也应当输入完整(图片大小会被调整)。
Emoji-smiley.png
:smiley: Emoji备忘录中有成百上千的Emoji表情符号,如果代码不起作用,你还可以用字符查看器(链接:Mac系统Windows系统)插入Emoji。

其他Markdown

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

你看到的效果 你输入的内容 备注
标题1 # 标题1 请参阅上方关于标题的说明。
标题2 ## 标题2
标题 3 ### 标题3
斜体文字 *斜体文字*

_斜体文字_

可以用“_”代替“*”
加粗文字 **加粗文字**
带删除线的文字 ~~带删除线的文字~~
斜体加粗文字 ***斜体加粗文字***

_非斜体_

# 非标题

**非粗体**

\_非斜体\_

\# 非标题

\*\*非粗体\*\*

需要输入一个Markdown中用于标记的符号,但又希望这个符号能直接显示出来时,就需要在每个用于标记的符号前加一个反斜杠“\”。
Code-zh.png
`代码` 键盘上没有“`”(反引号)的国际用户,可以在按住ALT键时输入“96”来插入反引号。
Quoted Text-zh.png
>被引用的文本 可以使用多个尖括号“>”,再次引用被引用的文本。
HighlightedParagraph-zh.png
在“这是一般的文本。”后按下Enter键或Shift键+Enter键两次来另起一个新的段落。在“这是突出显示的段落。”前空四格。 这样就能突出显示一个段落。
Multi paragraph code block-zh.png
在新的一行开头输入三个反引号(```),然后就可以在接下来的几行中输入文本或代码。要结束这个代码块,另起一行,然后再输入三个反引号(```)即可。

较长的段落并不会自动换行。要想得到左侧图片中换行的效果,需要手动插入换行符。

按下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的地方使用。

你看到的效果 你输入的内容 备注
展示大型任务进展的进度条,进度的数值可以手动修改。
![进度](https://progress-bar.dev/28/ "进度") 进度条可以嵌入Habitica中,用于显示每个习惯、每日任务、待办事项(甚至每个清单项目)或奖励的进度百分比,也可以在Habitica中其它支持Markdown的地方使用。
Progress bars Sample.png

更多示例请查看GitHub上的项目页面

数学公式与图形(LaTeX)

示例(点击放大)

![替代文本](图片URL地址 "鼠标悬停时显示的文本(可选)")

将“图片URL地址”替换为使用下面的方法生成的图像链接:

  1. QuickLaTeX(或TikZ)中输入数学公式的相应字符串,然后设置偏好。如果你不熟悉LaTeX语法,也可以尝试使用网上的可视化编辑器(如HostMath)创建一个字符串,然后将其复制到QuickLaTex的输入框中。
  2. 点击Render按钮。网站将生成一张服务器缓存的图片,并显示指向这张图片的链接。
这使用了Markdown中常见的插入图像的语法来插入数学公式和图形。

替代文本,是指图片因网速太慢或网址错误等原因无法显示,或者是使用屏幕朗读器时,替代图片显示的文字。替代文本必须要输入。[需要信息]同时,图片URL地址也应当输入完整(图片大小会被调整)。

另见

Advertisement