一、巧用MarkDown及HTML
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
1.标题
Markdown 标题有两种格式:
使用 = 和 - 标记一级和二级标题
使用 # 号表示 1-6 级标题
一级标题
=======
二级标题
--------
2.段落
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。
而如果使用HTML语言,可以使用
换行。
3.字体
Markdown 可以使用以下几种字体:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
如果你想使用五颜六色的字,或是自定义字的大小和字体,可以使用HTML:
红色3号字体
蓝色2号字体
蓝色verdana字体
4.列表
Markdown 支持有序列表和无序列表。
无序列表
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容。
- 第一项
- 第二项
- 第三项
有序列表
有序列表使用数字并加上 . 号来表示,如:
1. 第一项
2. 第二项
3. 第三项
显示效果如下图所示:
列表嵌套
列表嵌套只需在子列表中的选项前面添加四个空格即可:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
显示效果如下图所示:
第一项:第一项嵌套的第一个元素
第一项嵌套的第二个元素
第二项:第二项嵌套的第一个元素
第二项嵌套的第二个元素
5.区块
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
> PaddlePaddle yyds!
显示效果如下:
区块也是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
> 最外层
> > 第一层嵌套
> > > 第二层嵌套
显示效果如下图所示:
最外层
第一层嵌套
第二层嵌套
6.数学公式
在论文中,我们经常会碰到数学公式,Markdown也是可以实现的,可以使用美元符 $ 包裹 TeX 或 LaTeX 格式的数学公式来实现。
$f'({{x}_{0}})=\underset{\Delta x\to 0}{\mathop{\lim }}\,\frac{f({{x}_{0}}+\Delta x)-f({{x}_{0}})}{\Delta x}$
显示效果如下图所示:
如果公式需要居中显示,可以使用两个美元符 $$ 包裹:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
显示效果如下图所示:
A1=B2+C12A_1=B^2+{C_1}^2A1=B2+C12
7.链接
链接的使用方法如下:
[如何写好一篇精选项目](https://aistudio.baidu.com/aistudio/projectdetail/1661657)
显示效果如下图所示:
点击蓝色字体即可访问。
参考资料:如何写好一篇高质量的精选项目?
8.图片
Markdown 图片语法格式如下:
开头一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
![](https://ai-studio-static-online.cdn.bcebos.com/93a76d0c6e9241c2935d767a8c86908c9780f9f762d74c35ae441f4606b95a02)
显示效果如下图所示:
Markdown 还没有办法指定图片的高度与宽度,如果需要的话,你可以使用HTML里的 标签:
显示效果如下图所示:
二、增加可读性及曝光率的小tips
1.让人眼前一亮的标题
好的标题能吸引人点开你的文章,因此,标题一定要突出你做的工作。就像下面这些项目一样:
基于PaddleNLP的小样本学习策略库EFL实现中文科学文献学科分类
机器的思考故事——计算机能学会牛顿第二定律吗?
飞桨常规赛:量子电路合成 5月第1名方案
还在担心发朋友圈没文案?快来试试看图写诗吧!
原来飞桨还可以这么玩!当人工智能邂逅蓝桥杯算法题,会擦出怎样的火花?
如果是科研类的项目,一定要突出你的优点,对标某一个算法,你的算法好在哪里;如果是创意类的项目,一定要突出你的创新点在哪里。
注意:
标题需对全文内容有概括性或包含技术关键词和场景关键词,让读者一眼就能明白内容主要说的是什么,且可以被用户搜索到。
简介应该是对标题的补充说明,主要补充标题中无法对项目内容进行概括的部分,也可以考虑项目来源、项目成就、主要贡献等。标题和简介写的充分,才更容易吸引人。
若标题或简介过于随意,则无法上到AI Studio首页,或被直接淘汰。
2.图文并茂,让读者快速了解你做了什么
对于科研类的项目,你需要快速让读者知道你的方法是什么:
接着展示你提出的新方法到底有多好,要跟别的算法对标:
有些科研类项目还应该解释一下为什么这样做的效果会好:
如果是创意类的项目,应该突出你的实现思路,你是怎么想到的,具体流程是什么:
效果展示也是很重要的:
注意:
项目内容需原创,且在AI Studio首发。若内容已在其他平台发布,请在其他平台注明“更好阅读体验可以访问AI Studio”;若内容之中有其他项目的借鉴之处,请将出处标明,以视对原作者的尊重,若无标明且有发现涉嫌抄袭,不可评比精品项目;若比赛获奖项目中有很大部分为Baseline或其他作者项目,要重点突出自我改进之处。
代码运行有很长的输出结果是否清空(如 loss,安装包等非必要输出)。如输出不可清除,请将最终结果以 MarkDown 形式展示或保证输出不超过2个屏幕的长度。可以尝试使用VisualDL可视化图文展示训练梯度下降。每个代码块上最好有文案说明,让读者更方便的理解代码。
投稿项目是否可正常运行,正文中涉及的Paddle产品名称是否有错。项目应逻辑清晰,条理规范,目录中小标题与小标题一定要规范;若想要调整正文字体大小,可以使用命令;涉及到官方词语不可出错,如(PaddlePaddle、PaddleHub、PaddleSeg、PaddleNLP);最好展示部分数据集并进行说明。
项目中禁止含有软文、商业宣传语等被AI Studio认为是商业推广的内容,严禁黄赌毒等违法内容。
3.写出遇到的困难及解决思路
很多作业写完项目后,就不注重最后的总结了,但其实总结一下项目的情况也是十分重要的,一方面是帮助自己理清思路,另一方面是给读者一些启发。
不错呀
谢谢
可以,Markdown的语法确实好像还蛮少的
哈哈 是啊