Markdown上手指南

简介: markdown 是一门很实用的标记语言,若是有HTML 基础学起来会非常快。演示效果均是从typora 展示的,为什么用它,因为它是一个成熟的 md 编辑器!• markdown 所见即所得, 部分还增加了人性化的交互(比如代码高亮)• 支持公式• 支持大部分的拓展语法• 支持主流的流程图渲染


前言


markdown 是一门很实用的标记语言,若是有HTML 基础学起来会非常快。


演示效果均是从typora 展示的,为什么用它,因为它是一个成熟的 md 编辑器!


  • markdown 所见即所得, 部分还增加了人性化的交互(比如代码高亮)
  • 支持公式
  • 支持大部分的拓展语法
  • 支持主流的流程图渲染


温馨提示:


已经会的不用往下面看了,文章的目的是给我们研发组的小伙伴快速上手的。

因为前端这块的文档基本切换到MD来维护,花了点时间录制了一波GIF演示

基础语法


基础语法是支持度最高的,市面上主流的 markdown 解析器基本都支持。


拓展语法需要借助不同的插件或者库实现,通用性没那么强。


注意点 : 所有标记仅支持英文模式(半角)!!

标题


# H1
## H2
### H3
#### H4
##### H5
###### H6



文字强调


粗体


**我是粗体**



粗体


_我是斜体_
*我也是斜体*



着重强调(粗体+斜体)


***我着重的强调,再哔哔我嫩死你***


列表


有序列表


有序列表的格式是:   数字小数点+空格+文本


1. afdslf
2. fsadfae
3. Ewarewr



无序列表


格式: 横线(星号) + 空格 + 文本


- asdklfjsaf 
- fasdfsadf 
* 发水电费卢卡斯
* 发顺丰惹我



列表混合及嵌套


不管是有序列表还是无序列表,都支持多级嵌套,也支持有序无序列表混用。


若是增加一些外部扩展,还支持todo混入


- 测试啊
  - 真的测试啊
  - 你不信啊
    1. 我是三级有序列表
    2. 呵呵哒
  - 唉



外部链接


格式:方括号小括号(链接)


[点击我就跳到百度了](https://www.baidu.com) 



图片引用展示


格式:感叹号+外部链接的格式。 链接支持相对引用!


![closeup photo of computer code screengrab](https://images.unsplash.com/photo-1524666643752-b381eb00effb?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1000&q=80)



水平分割线


格式: 空行 ---


呼叫逗比
---
逗比回应你了


引用


一般你引用了别处的内容,这个就可以用上了

格式: 大于号(>) + 空格 + 内容


>床前明月光
>
>疑是地上霜
>
> - 这是**李白**的诗歌 



行内代码


行内代码的效果通用都是灰色,不能针对语法高亮


格式:反引号+内容+反引号


`module.exports= ()=>{}`



拓展语法


表格


表格的语法也很简单,就是写的多一些,因为列越多写的越多。


默认的列左对齐,也支持设置居中和右对齐, 横杆大于等于3, 列的竖必须闭合才能代表一列!


  • 默认对齐(左对齐) :  :----
  • 居中对齐 : :---:
  • 右对齐: ---:


| 默认左对齐     |       居中对齐       |     右对齐 |
| :--- | :------------------: | -------: |
| 啊水电费萨德 | 阿斯顿六块腹肌阿斯顿 | 发水电费 |
| 1321 | 432 | 654645 |
| 啊水电费萨德 | 阿斯顿六块腹肌阿斯顿 | 发水电费 |
| 1321 | 432 | 654645 |



代码高亮


代码高亮看采用的是什么高亮库了,比如前端这块有用highlightjs 或 prism的。

所以高亮支持语言也得看高亮库是否支持!!


我是纯文本 plain text,因为我没有指定语言


```javascript
// 我是 js 高亮
import vue from 'vue';


# 我是 bash 高亮
ls -l | grep 'haha'


任务列表


这个很实用,就是展示待办事项效果, 算是列表的变种,可以混合使用


  • - [ ] text : 方括号内部空格代指是待办事项
  • -  [x] text : 方括号内部 x代指事项已经完成


- v1版本
  - [x] 用户接口打通
  - [ ] 用户接口合并
    - [ ] 合并重复字段
    - [ ] 呵呵到



文字高亮


格式:双等号+文本+双等号


===听说我要呗高亮了===
==是啊==
==亮瞎眼了==



脚注


这个东西在写文献用的最多


格式:


  • 声明: [^text]: description
  • 引用: hello[^text]


[^李白]: 一个喝酒的诗人
床前明月光[^李白]



删除线


你没看错,这不属于第一个版本的草案的内容,也是后续才有的

格式:两个波浪线+文本+波浪线


~~我给删除了,你看~~



下标


把字缩放,适合用来表现公式类的


H~2~o



mermaid


mermaid 不仅仅可以画流程图,具体可以看mermaid 上手指南




目录
相关文章
|
18天前
|
人工智能 缓存 前端开发
DeepSeek Harness 首发实测 + 入门教程,夯爆了!梁神我错了
DeepSeek Harness + DeepSeek V4 Pro 项目实战保姆级教程!手把手带你从零安装开源 AI 编程工具,开发架构图、知识讲解网站、3D 网页游戏、全栈 AI 应用 4 个项目,覆盖运行模式选择、插件安装与开发,看看能不能对标 Claude。
13058 82
DeepSeek Harness 首发实测 + 入门教程,夯爆了!梁神我错了
|
7天前
|
人工智能 自然语言处理 安全
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
本文聚焦阿里云2026年推出的三款自研AI办公产品,清晰拆解千问办公、Qoder Teams、Qoder CN的差异化定位与能力边界:千问办公主打职场全场景提效,支持自然语言指令一键完成PPT生成、数据分析等高频办公任务;Qoder Teams面向程序员团队,深度整合AI代码生成、团队协同与企业知识库能力;Qoder CN则专为金融、政务等强合规场景打造,实现数据不出境与VPC私有化部署。文章同步给出分场景选型指南与最新活动定价,帮助不同类型的企业按需组合产品,实现业务岗、研发岗与强合规场景的AI能力全覆盖。
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
|
2天前
|
缓存 人工智能 API
阿里云Qwen3.8‑Flash完整能力解析:模型特性、API调用实操与计费规则深度拆解
在AI应用快速落地的当下,开发者与企业选型大模型API,不再只单纯关注评测榜单分数,推理速度、上下文长度、多模态能力、工具调用稳定性以及实际调用成本,共同决定项目能否平稳上线。Qwen3.8‑Flash作为新一代多模态混合专家模型,主打高性能推理与低成本开销,面向编程开发、智能Agent工作流、超长文档解析、图文混合理解等高频场景,提供托管API服务,权重同时开放可供本地部署,兼容主流接口协议,能够无缝接入各类开发工具链。很多开发者在接入过程中,容易混淆普通按量Token计费、缓存计费、各类订阅计划之间的差异,造成实际账单超出预估。本文从模型底层架构、核心功能能力、适用场景、API调用实操、完
650 0
|
12天前
|
Web App开发 人工智能 API
16 个超火的 DeepSeek Harness 插件,大肥鱼已经落后 N 个版本了。。。
DeepSeek Harness 精选插件推荐合集,从图片识别、浏览器操控、多 Agent 协作到手机远程控制,一口气带你看完 DSH 社区热门的十几个插件,覆盖技能扩展、UI 界面增强、整活玩法三大类,让你的鲸鱼变得更强。
1713 4
|
13天前
|
人工智能 Java BI
【AI】DeepSeek Harness 安装、运行、管理插件
本文介绍了如何运行DeepSeek开源的Agent框架DeepSeek Harness(dsh)。主要内容包括:使用nvm安装适配的Node版本;通过代理加速克隆GitHub源码;使用pnpm安装依赖并启动项目;配置DeepSeek API Token;安装扩展功能的插件。该框架自带Web界面,支持模型适配、文件编辑等插件化功能
1878 1
|
人工智能 JavaScript 开发工具
DeepSeek Harness 本地安装与使用指南
DeepSeek Harness(DSH)是DeepSeek AI开源的Agent运行框架,支持本地文件操作、命令执行与工具调用。基于Cordis插件架构,具备高扩展性与强可控性,适合开发者搭建可控Agent环境或开展模型基准测试。当前为开发者预览版,需Node.js环境,推荐先用`npx @deepseek-ai/dsh web`快速体验。
5108 0
|
15天前
|
人工智能 JavaScript 测试技术
保姆级教程:DeepSeek Harness从安装到跑通测试,30分钟上手
DeepSeek Harness是DeepSeek开源的AI Agent运行时,主打“一行命令安装、5分钟跑通”。它让模型真正动手干活——读代码、跑测试、分析失败、生成修复方案。本文手把手教你30分钟从零上手,覆盖安装、配置、实测及避坑指南,助你快速掌握下一代AI编程范式。
|
7天前
|
人工智能 Linux iOS开发
Ollama使用教程:Ollama官网下载、Ollama本地部署大模型(2026最新)
Ollama 是一款免费开源的本地大模型运行工具,支持在 Windows/macOS/Linux 上离线运行 Qwen、DeepSeek、Llama 等主流开源模型,数据不出本机、隐私安全。提供 OpenAI 兼容 API,命令行一键拉取/运行/管理模型,无需联网,无调用限制,是开发者与 AI 爱好者部署本地 AI 助手的理想选择。(239 字)
|
14天前
|
人工智能 JavaScript 测试技术
从 0 到 1,DeepSeek Harness 保姆级安装与使用教程!
DeepSeek Harness是DeepSeek推出的开源Agent运行框架,秉持“一切皆插件”理念,支持模型、工具、技能、工作流等全模块自由替换与扩展。其核心Cordis内核实现动态插件管理,赋能Agent自进化。已成GitHub史上增速最快开源项目(15w+ Star),标志着国内大模型从拼价格转向重架构与生态的新拐点。
1336 6
从 0 到 1,DeepSeek Harness 保姆级安装与使用教程!