跳转至

README

README 功能可以以Markdown形式渲染特定的注释,让其它人了解你的项目。

注意啦

每个README仅会在自己的角色/舞台内显示,而不互通

创建

首先,你需要创建一个新的注释

README

在其中填入以

#README
开头的文本,并在后面填入Markdown格式的内容

README

完成后,上方(或左方)会多出一个按钮:

  • 启用“VScode 布局”

    README

  • 未启用“VScode 布局”

    README

点击它,就能看见README了!

README

特性

多README

你可以创建多个README,并查看。 举个例子,我们创建3个README:

README

以同样的方式打开:

README

是的,上面出现了一个选择菜单,你可以切换他们!

标题

如果你需要为一个个功能制作一个单独的README,但是默认的以序号为标题难以区分的话,你可以将开头改为:

#README #标题
举个例子: README

README

自动打开

如果你希望当打开项目的时候自动打开README来告诉用户一些信息,那就接着看下去吧!

在制作之前,请确认你启用了“自动显示README”,不然测试时可能会不按预期运行。

README

然后你需要创建一个名为“README”的新角色,你可以在此随便编辑,只要名字不变就行。

README

同上,编写一个README并保存。这样,只要用户启用了“自动显示README”,当项目加载完成后这个角色的README就会自动显示出来了!

兼容

我们使用react-markdown(4.3.1),所以会出现部分不兼容的Markdown语法,这在未来会得到扩充。 现在,这个功能大致支持:

标题    # H1, ## H2, ### H3, #### H4, ##### H5, ###### H6
加粗    **BOLD**__BOLD__
斜体    *ITALIC*_ITALIC_
删除线    ~~STRIKETHROUGH~~
列表    无序: - ITEM, * ITEM, + ITEM; 有序: 1. ITEM
链接    [TEXT](URL)
图片    ![ALT](URL)
引用    > QUOTE
代码    行内: `CODE`; 代码块: ```CODE``` (或缩进4空格)
任务列表    - [ ] TASK, - [x] DONE
脚注    TEXT[^1] 和 [^1]: FOOTNOTE <!-- 可能有问题-->