markdown技巧整理

个人常用的 md 文件

Posted by 汤汤 on November 15, 2023

持续更新,平时会用到的markdown编辑指令

怎么让MD更美观

基本

  • 标题 #、粗体 ** **、斜体 * *、删除线 ~~ ~~、分割线 ---、超链接 []()
    • 引用 >、列表 - / 1. 、代码块
    • 脚注 [^1] / [^1]:、待办事项 [ ] / [x]
  • Markdown 进阶语法:
    • 数学公式:行内公式 $...$、行间公式 $$...$$
    • 支持 HTML 元素:<br>/<hr>/<b></b>/<i></i>/<kbd></kbd>
  • 脚注
    • 名词[^脚注num]效果为 名词[^脚注num]
    • [^脚注num]:解释效果为 [^脚注num]:解释
  • 表格
    • 单元格内换行:内容1<br>内容2
                |  表头   | 表头  |
                |  :----  | ----  |
                | 单元格  | 单元格 |
                | 单元格  | 单元格 |
      
  • 注释
    • <!--被注释的内容-->
  • 任务列表
    • - []
    • - [x]复选框

      表情

  • 复制 表情
    • 🎅⭐👀👇 😀
    • ✅ ⬇️ ☑️ ⬆️ ⬅️ ➡️ ↪️ 🔁 ↗️
    • 🅱️ 🩸
    • 🥂
    • 🖱️ 🖨️ ⌨️ 💻
    • 🧨 🐉 🌜
    • 🌒 🌕 🌗 🌘 🌑
    • 🚫 🙅 ⛔
    • 1️⃣ 2️⃣ 3️⃣
    • 🛎️ ❓❔ 🤷🏻 🤷 🤷🏼
  • 表情符号简码列表-github

超链接

目录
  • doctoc

    npm install -g doctoc doctoc yourtargetfile.md

  • [toc]

    直接在 yourtargetfile.md 文件最前面输入[toc]即可 缺点:只能生成文字目录,不支持超链接

    玩转字体

    字体颜色
  • 借助 html
<font color=red>我是红色</font>
<font face="黑体" color=green size=5>我是黑体,绿色,尺寸为5</font>
<font color="#FF5733">我是橙色</font>
我是红色 我是黑体,绿色,尺寸为5

<table><tr><td bgcolor=yellow>给字体加背景色</td></tr></table>

给字体加背景色

怎么让MD更便捷

图片上传图床

本地的图片加载到MD文件中太容易丢了,共享很容易出问题,将本地图片上传到github仓库作为图床,利用PicGo为图床里的图片生成链接,之后markdown再导入图片就很舒服!

  • 创建GitHub仓库
  • GitHub账号点击setting $\Rightarrow$ developer settings $\Rightarrow$ personal access tokens $\Rightarrow$ generate new token(classic)
    • 在最后的配置中,有效时间选择无限。
    • select scopes中勾选repo。
    • 确定生成即可
  • 保存好生成的token,它只显示一次
  • 打开PicGo $\Rightarrow$ 图床设置 $\Rightarrow$ GitHub图床 $\Rightarrow$ 填写相关信息
    • 仓库名:username/repname
    • 分支:一般为main
    • token:刚刚生成热乎的token
    • 存储路径:默认为空即可
    • 自定义域名:默认为零即可
  • 至此,可在上传区上传图片 参考自此文章
mermaid画流程图
  • 先把需求丢给chatgpt得到一个初始的mermaid画图代码
    • vscode中默认不支持mermaid预览,需要先安装mermaidpreview插件
    • md文件上传到GitHub发现,GitHub不能渲染mermaid语法
  • 在线渲染网站 Mermaid Live Editor
    • 实时编辑代码,预览图片
    • 登录后可以右上角share生成在线的svg图片分享链接
      • 不过这个链接上传在博客中,无法正常显示,原因可能是GitHub不支持渲染外部网站的svg图片
    • 登陆后也可以左侧栏save导出为png、svg或MMD等格式的本地文件
  • 本地文件通过PicGo上传到GitHub图床,得到的GitHub仓库内部链接,就可以正常在博客中显示了
  • 有啥问题还可以继续问问chatgpt