Markdown 语法学习笔记

一份 2014 年记的入门笔记,按目录 / 文本 / 链接 / 图片 / 列表 / 代码 / 表格分块

Posted by BY on April 25, 2026

原始笔记是一份 2014 年自己练手写的 Markdown 入门,文档里的标题用的是不带空格的 ## / ###(在 GitHub 渲染下会失效),还混杂了 <a name> 锚点写法。这里只做”包一层 front matter + 在每个示例外面再加一层标题层级”的轻整理,保持原始正文不动——它本身就是一个语法演示页面,改了反而失真。

当前保留内容

下面缩进的部分整体来自原笔记。注意:所有 #一级标题 / ##二级标题 之类示例为了保持原始示例效果故意写在代码块外,渲染出来仍会被 Jekyll 识别为标题,仅作为对照示例阅读,不要把它们视作本文真正的章节。

原始正文

Markdown语法学习

这是篇Markdown的学习文件 ————- ###           写于:14/07/21 ####(换行Tip:将输入法从半角切换到全角之后输入空格即可换行,So Easy)

=======================

##目录

##有序列表

  1. 目录1
  2. 目录2
  3. 目录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)。