Habitica Wiki
Advertisement
Habitica Wiki

Markdown是一种排版文字和插入图片的方法。它能在Habitica社交部分的聊天功能中使用,任务奖励清单的标题和注释也可以使用。

用Markdown插入的图片可以在任何网页上托管。(在不使用Markdown的情况下,Emoji也可以用来插入小图片,但可供选择的图片是有限的。)

注意,Markdown生成的格式(如下表所示)在手机app中可能无法按预期显示。

Markdown示例[]

如下表所示,可以通过在文本前面加上一个或多个#(哈希标记)来创建不同级别的标题。Markdown指定了6个标题级别(H1~H6);最小的标题使用六个哈希标记。哈希标记必须在放在一行的开头,同时哈希标记和标题文本之间必须空一格;否则,这些哈希标记将保持可见,文本也不会放大。在聊天中,只在必要的时候使用标题,因为它们占用了大量的空间。

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

_斜体文字_

_ 可以用来代替*
粗体文字 **粗体文字**
带删除线的文字 ~~带删除线的文字~~
粗体且斜体的文字 ***粗体且斜体的文字***
_不是斜体_

# 不是标题

**不是粗体**

\_不是斜体\_

\# 不是标题

\*\*不是粗体\*\*

当输入一个Markdown中的符号时,如果你希望这个符号能正常显示,那么在每个符号前加一个反斜杠\。
Code.png
`code` 键盘上没有`(反引号)的国际用户可以在按住ALT键时输入“96”来插入反引号。(译者注:96需要用数字小键盘输入。)
HighlightedParagraph.png
在“This is standard text(这是一个标准文本)”后面按Enter或Shift-Enter两次来生成一个新段落。在“This is a highlighted paragraph(这是一个突出显示的段落)”前空四格。 用这个方法来突出显示一个段落
Multi paragraph code block.png
在新行中输入三个反引号(```)。

在后面的行中只需要输入代码即可。长段落会自动换行。Enter 或Shift-Enter会生成一个换行符。Enter或 Shift-Enter两次增加一个空行。

在新一行中输入三个反引号(```)来结束这个代码块。

和之前突出显示文本的方法不同,这个方法不需要在每个段落开头空四格。

Markdown 代码块显示为未格式化的文本,通常用于展示软件代码。

键盘上没有`(反引号)的国际用户可以在按住ALT键时输入“96”来插入反引号。(译者注:96需要用数字小键盘输入。)

一行文本
一行在它之下的文本
在第一行后面输入两个空格,然后按一次Enter 或Shift-Enter来生成下一行。 输入文本,输入两个空格,换行,输入文本

一行文本

一行在它之下的文本,两行之间有空行

在聊天窗口中按两次Enter或Shift-Enter来生成这种格式。提交之前你的文本应该看起来是这样的:

一行文本

一行在它之下的文本,两行之间有一个空行

输入文本,空一行,输入文本
    手动    空白     文本 单词前面、单词之间可以有多个空格。 便于任务标题的居中或位置调整。
• 无序(项目符号)列表 在新行中输入+或*或-后空一格。 键盘上没有+(加号)字符的国际用户可以在按住ALT键时输入“43”来插入+。(译者注:43需要用数字小键盘输入。)
1. 有序(编号)列表 在新行中输入1.后空一格。
水平线 在聊天窗口中按两次Enter或Shift-Enter,---,然后再按两次Enter或Shift-Enter来生成一条横线。 或者按一次Enter或Shift-Enter, 三个下划线(___),然后再按一次Enter或Shift-Enter。 输入文本,空一行,输入三个短划线(---),空一行,输入文本。

或者

输入文本,换行,输入三个下划线(___),换行,输入文本。

注意,通过这两种方法生成的水平线不会在手机app中显示。

表格型文本

第一个标题 第二个标题
内容单元格   内容单元格
内容单元格   内容单元格

第一个标题|第二个标题
------------- | -------------
内容单元格|内容单元格
内容单元格|内容单元格

非常适合将标题与文本对齐。

只需要三个连字符 (---);然而,使用三个以上的连字符还是可以正常显示的。

Habitica [超链接](网站URL地址放在这里)

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

请注意,方括号和圆括号之间没有空格。在Habitica网址中,确保不要包含“www”。
Zombie hatching potion
![替代文本](图片URL地址放在这儿 "可自选的鼠标悬停时显示的标题") 替代文本指图片无法显示或者有人使用了屏幕阅读器时替代图片显示的文字,图片无法显示的原因有网络连接缓慢,URL地址错误。替代文本必须存在。输入图片的完整URL地址(图片大小会被调整)。
Emoji-smiley.png
:smiley: Emoji备忘录中有数百种Emoji表情符号,如果代码不起作用,你可以用字符查看器(macwindows)插入Emoji。

–
—
Markdown支持HTML语言实体类。 要使用它们,只需键入或插入一段文本(“字符串”)。 字符串以与号(&)开头,以分号(;)结尾。

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

你看到的效果 你输入的内容 备注
A progress bar that can be manually updated to display your progress on a large task.
![progress](https://progress-bar.dev/28/ "progress") 进度条可以嵌入Habitica中,以显示每个习惯、每日任务、待办事项(甚至每个清单项)或奖励的相对进度,Habitica中其它支持Markdown的地方也可以使用。

Progress bars Sample.png

更多示例请参阅Percent Bar Maker 。

数学公式与图形 (LaTeX)

示例(点击放大)

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

将'图片URL地址放在这儿' 替换为以下面的方法生成的图像链接:

  1. QuickLaTeX (也支持TikZ )中输入数学字符串,然后进行偏好设置。 如果您不熟悉LaTeX语法,请尝试使用在线可视编辑器(例如 HostMath )创建一个字符串,然后将其复制到QuickLaTex的输入框中。
  2. 点击Render按钮。网站将生成一个缓存在服务器上的图片,并提供一个指向该图片的链接。
这个方法是使用常规的Markdown图像语法来插入数学公式和图形。

替代文本指图片无法显示或者有人使用了屏幕阅读器时替代图片显示的文字,图片无法显示的原因有网络连接缓慢,URL地址错误。替代文本必须存在。输入图片的完整URL地址(图片大小会被调整)。

地图 (使用 OSM)

示例(点击放大)

![map](http://staticmap.openstreetmap.de//staticmap.php?center=51.50131,-0.12028&zoom=17&size=350x350&maptype=osmrenderer "map")
(译者注:由于staticMapLite不稳定,地图可能无法正常显示。)
  1. OpenStreetMap.org 找到你想要的位置,然后把它大致放在你的屏幕中央。
  2. 用浏览器地址栏中的值替换上面Markdown示例中的地图坐标和缩放级别。例如,左侧Markdown示例/缩略图的原始链接是
    https://www.openstreetmap.org/#map=19/51.50131/-0.12029
    (19是缩放等级,其他两个数字是坐标).
使用OpenStreetMap和staticMapLite插入地图。要了解更多示例,请访问后者。

如果直接从地址栏中复制坐标,请记住用逗号(,)替换坐标之间的正斜杠(/)。 另请注意,虽然较低的缩放级别有效,但在Habitica上可能无法清晰显示。

size参数指定以当前位置为中心的矩形的宽度和高度,将其裁剪以生成最终图像。

另见[]

Advertisement