原始笔记是一份 2014 年自己练手写的 Markdown 入门,文档里的标题用的是不带空格的
##/###(在 GitHub 渲染下会失效),还混杂了<a name>锚点写法。这里只做”包一层 front matter + 在每个示例外面再加一层标题层级”的轻整理,保持原始正文不动——它本身就是一个语法演示页面,改了反而失真。
当前保留内容
下面缩进的部分整体来自原笔记。注意:所有 #一级标题 / ##二级标题 之类示例为了保持原始示例效果故意写在代码块外,渲染出来仍会被 Jekyll 识别为标题,仅作为对照示例阅读,不要把它们视作本文真正的章节。
原始正文
Markdown语法学习
这是篇Markdown的学习文件 ————- ### 写于:14/07/21 ####(换行Tip:将输入法从半角切换到全角之后输入空格即可换行,So Easy)
=======================
##目录
- 有序目录
- 横线
- 标题
- 显示文本
- 普通文本
- 单行文本
- 多行文本
- 文字高亮
- 超链接
- 文字超链接
- 链接外部URI
- 链接本仓库里的URI
- 锚点
- 图片超链接(暂无)
- 文字超链接
- 显示图片
- 网络图片
- Github仓库里的图片
- 给图片加上超链接
- 列表
- 符号包围
- 代码高亮
- 插入表格
- 总结
- 目录1
- 目录2
- 目录3,前面的数字不影响显示,效果仍然为3
#一级标题 ##二级标题 ###三级标题 ####四级标题 #####五级标题 ######六级标题
##显示文本
###这是一段普通文本,直接回车不能换行,
要使用<br>
###或者在两段文本中加一个空行,也能实现换行效果
###单行文本 这是个单行文本(使用Tab符即可实现单行文本)
###多行文本 这是多行文本 在每行行首添加Tab符即可实现多行文本
###文字高亮
这是文字高亮字符串,使用两个 包围起来字符串即可。这个字符是Tab上方,1左边的按键,注意要在英文输入法状态下输入
####高亮功能可以用来做一篇文章的Tag
例如:
Xcode Tag Github教程
####删除线
这是一个删除线
####斜体
这是斜体文字1
这是_斜体文字2_
####粗体
这是粗体文字1
这是__粗体文字2__
##文字链接 ###链接外部URL 百度首页 ###锚点 点击回到目录
##显示图片
###网络图片
###Github仓库中的图片
###给图片加上超链接
![baidu]
[baidu]:http://www.baidu.com/img/bdlogo.gif
- 列表1
- 列表2
- 列表3
###更多圆点
- 一级目录
- 二级目录
- 三级目录
- 二级目录
###复选框列表
- C
- C++
- C##
###缩进 ###列表缩进
第一层缩进
第二层缩进
第三层缩进
第四层缩进
第五层缩进
###用于引用: ####下面这段话摘自《某本书》
“当你定义一个函数时,你可以定义一个或多个有名字和类型的值,作为函数的输入(称为参数,parameters),也可以定义某种类型的值作为函数执行结束的输出(称为返回类型)。”
##代码高亮
public static void main(String[] args){} //Java片段
println("Swift语句") //Swift片段
UIView *testView = [[UIView alloc] init];
##插入表格 姓名 | 年龄 | 性别 — | — | — 张三 | 20 | 男 李四 | 21 | 男 这是很长的名字|18|女
| Name | Age |
|---|---|
| 名字1 | 30 |
| 名字2 | 20 |
| 靠左对齐(左边写:) | 居中对齐(两边写:) | 靠右对齐(右边写:) |
|---|---|---|
| 左边 | 中间 | 右边 |
| ←_← | 居中 | →_→ |
##总结 ###终于把基本的Markdown语法都联系了一下,算是入门了把,继续努力!Over!
后续可补的方向
- 把
<a name>锚点改成现代 GFM 自动生成的 slug,并校验目录跳转是否仍然正确。 - 给”代码高亮”小节补上语言标签(如
```swift),让 highlight 真正生效。 - 补一节 GitHub Flavored Markdown 特性(任务列表、表情、callout、mermaid)。