wiki编写 - web240/web240.github.io GitHub Wiki
#区块元素
##段落
前后各一个空行
段落里换行 可以用两个以上的空格后加回车
##标题
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶
##区块引用
在每行前加>,也可以愉懒在段落前加>,并且可以嵌套使用
可以在里面使用其它Markdown语法
##列表
无序列表使用星号、加号或是减号作为列表标记
有序列表则使用数字接着一个英文句点
列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符
如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用
标签包起来
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符
项目列表中,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠
##代码区块 要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以
##分隔线 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格
#区段元素
##链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式
行内式的链接只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
如果你是要链接到同样主机的资源,你可以使用相对路径
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记,你也可以选择性地在两个方括号中间加上一个空格,接着,在文件的任意处,你可以把这个标记的链接内容定义出来,链接内容定义的形式为:
方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
接着一个冒号
接着一个以上的空格或制表符
接着链接的网址
选择性地接着 title 内容,可以用单引号、双引号或是括弧包着
请注意:有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title。
##强调
Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 标签包围,用两个 * 或 _ 包起来的话,则会被转成
你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线
##代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入反引号
##图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字
参考式
#其它
##反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠
转义其它字符
``\ 反斜线
` 反引号
- 星号 _ 底线 {} 花括号 [] 方括号 () 括弧
- 加号
- 减号 . 英文句点 ! 惊叹号 ``
##自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样
邮址的自动链接也很类似,只是 Markdown 会先做一个编码转换的过程,把文字字符转成 16 进位码的 HTML 实体,这样的格式可以糊弄一些不好的邮址收集机器人
在你库里面的文件夹下 点击wiki进入编辑页面
如何编辑:
header以#开始, #代表一级header, ##代表二级header...
段落直接以空行分隔。
每行后面加两个以上的空格
分条列举的时候,无规则的时候,每一条前面加上*号
加链接: Scipy
斜体: content
浅灰色底纹(如代码之类的):content
如果是好几行, 用:
few lines
插入图片: 
和加链接不同的是前面有一个感叹号
~/wiku/jcvi.wiki
标题
标题 标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。
以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法。
列表 熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。
无序列表与有序列表 引用 如果你需要引用一小段别处的句子,那么就要用引用的格式。
例如这样 只需要在文本前加入 > 这种尖括号(大于号)即可
引用 图片与链接 插入链接与插入图片的语法很像,区别在一个 !号
图片为:{ImgCap}{/ImgCap}
插入图片的地址需要图床,这里推荐围脖图床修复计划 与 CloudApp 的服务,生成URL地址即可。
URL 与图片 粗体与斜体 Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。
例如:这里是粗体 这里是斜体
表格 表格是我觉得 Markdown 比较累人的地方,例子如下:
| Tables | Are | Cool |
|---|---|---|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
| 这种语法生成的表格如下: |
Tables Are Cool col 3 is right-aligned $1600 col 2 is centered $12 zebra stripes are neat $1 代码框 如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来。图例:
使用 tab 键即可缩进。
分割线 分割线的语法只需要三个 * 号,例如:
到这里,Markdown 的基本语法在日常的使用中基本就没什么大问题了,只要多加练习,配合好用的工具,写起东西来肯定会行云流水。更多的语法规则,其实 Mou 的 Help 文档栗子很好,当你第一次使用 Mou 时,就会显示该文档。可以用来对用的查找和学习。