Markdown基础与应用

Markdown概述Markdown编写的文档可以导出HTML、Word、图像、PDF、Epub等多种格式的文档。Markdown并不是HTML的替代品而是HTML的简化版本。两者的关系可以这样理解Markdown源码 → 解析器 → HTML输出 → 浏览器渲染Markdown标题使用#号可以表示1-6级标题一级标题对应一个#号二级对应两个以此类推。注#号和标题文字之间必须有一个空格。二、Markdown文本格式2.1 字体粗体使用两个星号包围文字粗体文字斜体使用一个星号包围文字斜体文字粗斜体使用三个星号。2.2 划线2.2.1 分隔线可以在一行中用三个以上的星号来建立一个分隔线。2.2.2 删除线在文字两端加上两个波浪线删除。2.2.3 下划线可以通过HTML的u标签来实现下划线。2.2.4 上下标使用sup上标标签和sub下标标签。2.2.5 引用文本()符号放在段落开头。引用文本2.2.6 行内代码标记用于标记正文中代码片段、命令、变量名等比如在终端中输入npm install安装依赖2.2.7 文本高亮可以用mark标签这是高亮文本。2.2.8 段落和换行换行建议在标题和内容之间留空行在列表前后留空行在代码块前后留空行保持一致的空行使用习惯。三、Markdown 列表3.1 无序列表和有序列表无序列表使用减号(-)作为列表标记后面加一个空格。第一项第二项有序列表使用数字并加上.号来表示。第1项第2项3.2 列表嵌套 (加缩进)①子列表需要缩进2-4个空格(推荐2个)②保持一致的缩进长度③可以无限层嵌套实际使用建议不超过3层。第一层第二层第三层3.3 任务列表 (复选框)未完成的任务已完成的任务未完成的任务二四、Markdown引用块应用引用块用于突出显示重要信息、引用他人观点或创建视觉层次。五、Markdown链接链接使文档内容丰富易于导航。5.1 直接链接5.2 参考链接参考式链接将链接定义与使用分离中间加了转移变量。5.3 自动识别链接5.4 锚点链接的使用锚点链接用于在同一文档内跳转。锚点规则标题会自动生成锚点锚点名称通常是标题的小写形式空格替换为连字符移除特殊字符。五、Markdown图片图片语法格式· 开头一个感叹号· 接着一个方括号里面放上图片的替代文字· 接着一个普通括号里面放上图片的网址最后还可以用引号包住并加上选择性的’title’属性的文字。相对路径示例绝对路径示例直接引用网络图片也可以像网址那样对图片网址使用变量图片alt文本的重要性Alt文本(替代文字)在图片无法显示时提供替代信息同时对无障碍访问和SEO很重要好的alt文本示例· 简介有描述性· 描述图片的主要内容和用途图片尺寸控制(HTML方式Markdown表格表格使用 | 来分隔不同的单元格使用 - 来分隔表头和其他行。对齐方式----:设置内容和标题栏右对齐。:----设置内容和标题栏左对齐。:—:设置内容和标题栏居中对齐。Markdown 高级技巧支持HTML元素不在Markdown涵盖范围内的标签都可在文档里用HTML撰写转义Markdown使用了很多特殊符号来表示特定的意义如果需要显示特定的符号则需要使用转义字符Markdown使用反斜杠转义特殊字符公式Markdown Preview Enhanced使用KaTex或者MathJax来渲染数学表达式。KaTex拥有比MathJax更快的性能但少了许多MathJax拥有的特性。