IE盒子

搜索
查看: 130|回复: 1

MarkDown 轻量级标记语言

[复制链接]

3

主题

12

帖子

18

积分

新手上路

Rank: 1

积分
18
发表于 2023-2-13 12:41:15 | 显示全部楼层 |阅读模式
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的 HTML 页面。 —— 维基百科
序言: 由于 MarkDown 的使用越来越频繁,所以整理一份 MD 语法笔记.
MarkDown 语法使用功能场景控制表格列宽自动生成目录手动指定目录空格输入字体高亮图片跳转(高级)md 侧边栏(不实用)页面跳转(高级)CSDN-MarkDwon 语法快捷键表格定义列表代码块脚注目录数学公式UML 图CmdMarkdown-MarkDwon 语法1. 待办事宜2. 书写公式3. 高亮代码4. 绘制流程图5. 绘制序列图6. 绘制甘特图7. 绘制表格附件扩展资源参考资源
功能场景

控制表格列宽

<span style="display:inline-block;width:100px">版本说明</span>自动生成目录

使用[toc]自动生成目录。 效果如上个目录所示
手动指定目录

- [MarkDown技巧](#MarkDown技巧)

  • MarkDown 技巧
  • MarkDown 工具
手动排版,生成目录。 CSDN 无法使用
空格输入

空格的使用:
 或  半方大的空白
 或  全方大的空白
 或  不断行的空白格
  常用一个汉字的空格字体高亮

字体高亮: 字体高亮 字体 Mark(有道云 MarkDown 可以使用) ==字体高亮 字体Mark==
图片跳转(高级)

图片链接跳转:
# 图片和链接的结合使用
[![图片说明](http://omhwhig1i.bkt.clouddn.com/17.jpg)](http://www.bilibili.com/)
md 侧边栏(不实用)

备注:由于此方法过于繁琐,且 CSDN / GItbook 自动支持这个,所以虽然很有用,但是实际用处不大
自动生成 Markdown 侧边栏目录: 自动生成侧边栏目录,需要网站相适应,含 css、js 等文件,无法独立成为一个 html 自动生成 Markdwon 侧边栏目录:
页面跳转(高级)

方法 1-HTML-ID 实现:
# 配置对应的 id
<h6 id="1">页内跳转样例1</h6>
# 配置跳转窗口
[页面跳转1](#1)​页内跳转样例1

跳转到-样例 1
方法 2: html 标签实现:
# 定义一个锚(id):
<span id="jump">跳转到的地方</span>
# 使用markdown语法:
[点击跳转](#jump)
# exp:
在文章末尾设置一个锚,然后跳转到文章开始的地方。跳转到的地方
点击跳转
CSDN-MarkDwon 语法


  • CSDN MarkDown 语法官方手册
快捷键


  • 加粗 Ctrl + B
  • 斜体 Ctrl + I
  • 引用 Ctrl + Q
  • 插入链接 Ctrl + L
  • 插入代码 Ctrl + K
  • 插入图片 Ctrl + G
  • 提升标题 Ctrl + H
  • 有序列表 Ctrl + O
  • 无序列表 Ctrl + U
  • 横线 Ctrl + R
  • 撤销 Ctrl + Z
  • 重做 Ctrl + Y
表格

Markdown   Extra 表格语法:
项目价格
Computer$1600
Phone$12
Pipe$1
可以使用冒号来定义对齐方式:
项目价格数量
Computer1600 元5
Phone12 元12
Pipe1 元234
定义列表

Markdown   Extra 定义列表语法: 项目1 项目2 : 定义 A : 定义 B
项目3 : 定义 C
: 定义 D
定义 D 内容
代码块

代码块语法遵循标准 markdown 代码,例如:
@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''脚注

生成一个脚注footnote.
[footnote]    这里是 脚注内容.
目录

用 [TOC]来生成目录:
@[toc]
数学公式

使用 MathJax 渲染LaTex 数学公式,详见math.stackexchange.com.

  • 行内公式,数学公式为:$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$。
  • 块级公式:
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
更多 LaTex 语法请参考 这儿.
UML 图

可以渲染序列图:
张三李四嘿,小四儿, 写博客了没?李四愣了一下,说:忙得吐血,哪有时间写。张三李四
或者流程图:


  • 关于 序列图 语法,参考 这儿,
  • 关于 流程图 语法,参考 这儿.
CmdMarkdown-MarkDwon 语法


  • Cmd Markdown 简明语法手册
1. 待办事宜


  • 支持以 PDF 格式导出文稿
  • 改进 Cmd 渲染算法,使用局部渲染技术提高渲染效率
  • 新增 Todo 列表功能
  • 修复 LaTex 公式渲染问题
  • 新增 LaTex 公式编号功能
2. 书写公式latex

$$E=mc^2$$
3. 高亮代码code

@requires_authorization
class SomeClass:
    pass

if __name__ == '__main__':
    # A comment
    print 'hello world'4. 绘制流程图


5. 绘制序列图

Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!6. 绘制甘特图

    title 项目开发流程
    section 项目确定
        需求分析       :a1, 2016-06-22, 3d
        可行性报告     :after a1, 5d
        概念验证       : 5d
    section 项目实施
        概要设计      :2016-07-05  , 5d
        详细设计      :2016-07-08, 10d
        编码          :2016-07-15, 10d
        测试          :2016-07-22, 5d
    section 发布验收
        发布: 2d
        验收: 3d7. 绘制表格

项目价格数量
计算机$16005
手机$1212
管线$1234
附件

扩展资源

图片外链配置(★★★★☆):

  • 图片外链网站配置参考博客:http://blog.csdn.net/u014727260/article/details/54897041
  • 图片外链工具网站:

    • 极简图床(http://yotuku.cn/#/)
    • 七牛云存储(https://portal.qiniu.com)


参考资源

MarkDown 编辑器:

  • Cmd Markdown 编辑阅读器
  • 有道云笔记 MarkDown 编辑器
MarkDown 编辑器语法:

  • 【简明版】有道云笔记 Markdown 指南
  • 【进阶版】有道云笔记 Markdown 指南
  • Cmd MarkDown 编辑器语法
  • GcsSloop 的博客 MarkDown 高级语法教程
回复

使用道具 举报

1

主题

5

帖子

3

积分

新手上路

Rank: 1

积分
3
发表于 2023-2-13 12:41:36 | 显示全部楼层
欢迎评论点赞[爱]
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

快速回复 返回顶部 返回列表