快速入门上手Markdown

第一次接触 Markdown是写代码初期看很多大佬的 github,他们的项目一定会有一份文件叫 Readme.md的文件
他们由一些简单美观的符号和汉字字母组成,编译之后成为一篇简单直观的文档
深入了解之后我才知道,原来还有这样一种神奇的标记语言,可以写出这么好看的文档

当然,在我们记录一些技术文档或者写技术博客的时候,也经常会头疼,如何写一篇技术文档,能够同时以美观的格式发布到多个博客平台呢?

Markdown就可以解决我们快速书写和多个平台适配的痛点,他可以用一些简单的标记符,来格式化你的文档,并且保证不同平台统一的格式

当然,由于各个平台的 Markdown解析器的配置不同,解析后的一些样式,比如字体粗细,超链接颜色,代码块颜色之类的,可能会稍有不同

可以说, Markdown就是为简单而生

因为我个人是从js开始接触代码世界,所以我选择的第一个编辑器是Hbuilder(注意官网已经不提供更新版本下载),
不过目前它已经升级版本到HbuilderX,这不是一个专门的 Markdown编辑器
但是他的内部集成了插件具有直接编写 Markdown的功能,就我个人而言我觉得非常适合写 Markdown文档,不仅不耽误写代码,
而且它的 Markdown文本标注的颜色非常符合我的审美。当然萝卜青菜各有所爱,还有以下一些 Markdown编译器大家都可以试试

_注意!!!_这里是我自己平时写文档和技术博客常用的一些Markdown标记,标注为我自己写文档使用的位置,不是这个标记的官方定义

大标题
### 段落标题
#### 特殊tip(会加粗成为目录中的标题,慎用,我是因为橘黄色才用这个作tip)
1. 有序列表
+ 无序列表
> 引用(需要垂直连续使用)
*文字* 倾斜
**文字** 加粗
***文字*** 加粗倾斜
[外部链接标题](外部链接地址 "标题") 外部链接,标题就是类似脚注,鼠标悬浮后显示的文字
单行代码 行内代码块
*2 多行代码块(注意这里是两排,中间写代码即可)
[锚链接标题](#锚链接id) +    组合使用可以完成锚链接,在当前文章内跳转到指定位置
一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
~需要标注删除线的文字~
~~需要标注删除线的文字~~
[^需要注明的文字]: 悬浮后显示的文字
1. 第一项
2. 第二项
3. 第三项
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项
1. 第一项:
    * 第一项嵌套的第一个元素
    * 第一项嵌套的第二个元素
2. 第二项:
    + 第二项嵌套的第一个元素
    + 第二项嵌套的第二个元素
3. 第三项
    - 第三项嵌套的第一个元素
    - 第三项嵌套的第二个元素
4. 引用内容
    > 引用一(注意如果要换行就加两个空格,默认是不换行,会自动把下面引用内容拼接过来)
    > 引用二
> 引用一
> 引用二
> 引用三

> 最外层
> > 第一层嵌套
> > > 第二层嵌套
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

* 列表中使用区块
* 第一项
    > 引用一
    > 引用二
* 第二项
code() 函数
// 这里用括号包裹防止误认为代码块
()javascript
$(document).ready(function () {
    alert('RUNOOB');
});
()
// 完整格式,可以重命名,另外可选外加标题,标题可以不写,标题类似脚注,悬浮显示文字
[链接名称](链接地址 "链接标题")

// 简洁格式
<链接标题>
</链接标题>
&#x8FD9;&#x4E2A;&#x94FE;&#x63A5;&#x7528; 1 &#x4F5C;&#x4E3A;&#x7F51;&#x5740;&#x53D8;&#x91CF; [Google][1]
&#x8FD9;&#x4E2A;&#x94FE;&#x63A5;&#x7528; abc123 &#x4F5C;&#x4E3A;&#x7F51;&#x5740;&#x53D8;&#x91CF; [Baidu][abc123]
&#x8FD9;&#x4E2A;&#x94FE;&#x63A5;&#x7528; runoob &#x4F5C;&#x4E3A;&#x7F51;&#x5740;&#x53D8;&#x91CF; [Runoob][runoob]
&#x7136;&#x540E;&#x5728;&#x6587;&#x6863;&#x7684;&#x7ED3;&#x5C3E;&#x4E3A;&#x53D8;&#x91CF;&#x8D4B;&#x503C;&#xFF08;&#x7F51;&#x5740;&#xFF09;

  [1]: http://www.google.com/
  [abc123]: http://www.baidu.com/
  [rb]: http://www.rb.com/
![alt &#x5C5E;&#x6027;&#x6587;&#x672C;](&#x56FE;&#x7247;&#x5730;&#x5740;&#x6216;&#x56FE;&#x7247;&#x7F51;&#x5740;)
![alt &#x5C5E;&#x6027;&#x6587;&#x672C;](&#x56FE;&#x7247;&#x5730;&#x5740;&#x6216;&#x56FE;&#x7247;&#x7F51;&#x5740; "&#x53EF;&#x9009;&#x6807;&#x9898;")
&#x8FD9;&#x4E2A;&#x94FE;&#x63A5;&#x7528; a &#x4F5C;&#x4E3A;&#x7F51;&#x5740;&#x53D8;&#x91CF; [RB][a].

&#x7136;&#x540E;&#x5728;&#x6587;&#x6863;&#x7684;&#x7ED3;&#x5C3E;&#x4E3A;&#x53D8;&#x91CF;&#x8D4B;&#x503C;&#xFF08;&#x56FE;&#x7247;&#x5730;&#x5740;&#x6216;&#x56FE;&#x7247;&#x7F51;&#x5740;&#xFF09;

  [a]: &#x56FE;&#x7247;&#x5730;&#x5740;&#x6216;&#x56FE;&#x7247;&#x7F51;&#x5740;
<img src="http://static.rb.com/images/rb-logo.png" width="50%">
|  &#x8868;&#x5934;   | &#x8868;&#x5934;  |
|  ----  | ----  |
| &#x5355;&#x5143;&#x683C;  | &#x5355;&#x5143;&#x683C; |
| &#x5355;&#x5143;&#x683C;  | &#x5355;&#x5143;&#x683C; |
| &#x5DE6;&#x5BF9;&#x9F50; | &#x53F3;&#x5BF9;&#x9F50; | &#x5C45;&#x4E2D;&#x5BF9;&#x9F50; |
| :-----| ----: | :----: |
| &#x5355;&#x5143;&#x683C; | &#x5355;&#x5143;&#x683C; | &#x5355;&#x5143;&#x683C; |
| &#x5355;&#x5143;&#x683C; | &#x5355;&#x5143;&#x683C; | &#x5355;&#x5143;&#x683C; |
<table>
    <tr>
        <th colspan="3">js-pratice</th>
    </tr>
    <tr>
        <th>&#x4E00;&#x7EA7;&#x76EE;&#x5F55;</th>
        <th>&#x4E8C;&#x7EA7;&#x76EE;&#x5F55;</th>
        <th>&#x63CF;&#x8FF0;</th>
    </tr>
    <tr>
        <td rowspan="3">Array</td>
        <td>Basic</td>
        <td>&#x6570;&#x7EC4;&#x57FA;&#x672C;&#x64CD;&#x4F5C;</td>
    </tr>
    <tr>
        <td>Repeat</td>
        <td>&#x6570;&#x7EC4;&#x53BB;&#x91CD;&#x64CD;&#x4F5C;</td>
    </tr>
    <tr>
        <td>Sort</td>
        <td>&#x6570;&#x7EC4;&#x6392;&#x5E8F;&#x64CD;&#x4F5C;</td>
    </tr>
    <tr>
        <td>Date</td>
        <td>Date</td>
        <td>&#x65E5;&#x671F;&#x5BF9;&#x8C61;&#x64CD;&#x4F5C;</td>
    </tr>
    <tr>
        <td>Inherit</td>
        <td>Inherit</td>
        <td>&#x7EE7;&#x627F;&#x5BF9;&#x8C61;&#x64CD;&#x4F5C;</td>
    </tr>
    <tr>
        <td>Promise</td>
        <td>Promise</td>
        <td>Promise&#x5BF9;&#x8C61;&#x64CD;&#x4F5C;</td>
    </tr>
</table>

我是 fx67ll.com,如果您发现本文有什么错误,欢迎在评论区讨论指正,感谢您的阅读!
如果您喜欢这篇文章,欢迎访问我的 本文github仓库地址,为我点一颗Star,Thanks~ 😃
转发请注明参考文章地址,非常感谢!!!

Original: https://www.cnblogs.com/fx67ll/p/15439422.html
Author: fx67ll
Title: 快速入门上手Markdown

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/599483/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

  • django-ckeditor配置html5video上传视频

    参考信息 为Django ckeditor配置上传视频:https://www.byincd.com/bobjiang/article-01128/ 使用 1. 手动下载插件 ht…

    数据库 2023年6月9日
    083
  • 数据库原理二—MySQL事务与锁

    数据库事务的四大特性 原子性A 事务是最小的执行单位,不允许分割。事务的原子性确保动作要么全部完成,要么完全不起作用 一致性C 执行事务前后,数据保持一致,多个事务对同一个数据读取…

    数据库 2023年6月6日
    065
  • python爬取博客圆首页文章链接+标题

    新人一枚,初来乍到,请多关照 来到博客园,不知道写点啥,那就去瞄一瞄大家都在干什么好了。 使用python 爬取博客园首页文章链接和标题。 首先当然是环境了,爬虫在window10…

    数据库 2023年6月11日
    089
  • 机器学习实战-决策树

    1.决策树的构造 1.1优缺点 优点: 计算复杂度不高:以ID3为例,每次运算都是基于某一列特征,特征计算完后,下次计算不考虑该最有特征,并且通过适当剪枝可以简化复杂度 输出结果易…

    数据库 2023年6月16日
    090
  • Java基础七—Java并发基础

    一个类在可以被多个线程安全调用时就是线程安全的。 线程安全不是一个非真即假的命题,可以将共享数据按照安全程度的强弱顺序分成以下五类: 不可变、绝对线程安全、相对线程安全、线程兼容和…

    数据库 2023年6月6日
    0242
  • Variable used in lambda expression should be final or effectively final

    java的lambda表达式里不能出现变量,必须是final修饰的,但是可以让变量在定义时候计算【新函数】出结果,这样就不算变量了。可以使用lambda表达式,不再报错。例如 bo…

    数据库 2023年6月9日
    082
  • 一次线上MySQL死锁告警原因排查

    项目场景:一次线上MySQL死锁告警原因排查最近处理了一次在线数据警报,记录下来。 [En] Recently handled an online data alarm, reco…

    数据库 2023年5月24日
    046
  • 【Kubernetes系列】Kubernetes组件介绍

    文章目录 概述 Control Plane(控制面) * etcd(分布式的键值对数据存储系统) kube-apiserver(API服务器) kube-scheduler(调度器…

    数据库 2023年6月6日
    097
  • Nginx基础入门篇(2)—编译参数介绍

    查看命令 nginx -V nginx version: nginx/1.22.0 built by gcc 4.8.5 20150623 (Red Hat 4.8.5-44) (…

    数据库 2023年6月14日
    079
  • django中的路由层

    1.什么是路由层 简单来说,就是通过路由层中的path函数,告诉django遇到那个url,执行那个视图函数 2.路由层的请求流程 1.&#x5BA2;&#x623…

    数据库 2023年6月14日
    078
  • Docker下Nginx、ES、Kibana、 Redis 安装和配置

    1.Nginx 1.拉取镜像 注意:不带版本默认会下载docker仓库里面最新的版本 docker pull nginx #下载最新版 镜像名:版本名(标签) docker pul…

    数据库 2023年6月6日
    073
  • 如何优化前端性能?

    导读:随着前端的范畴逐渐扩大,深度逐渐下沉,富前端必然带来的一个问题就是性能。特别是在大型复杂项目中,重前端业务可能因为一个小小的数据依赖,导致整个页面卡顿甚至崩溃。本文基于Qui…

    数据库 2023年6月14日
    056
  • JavaWeb核心篇(5)——Filter和Listener

    JavaWeb核心篇(5)——Filter和Listener JavaWeb具有三大组件:Servlet,Filter,Listener 在之前的文章中,我们已经学习了Servle…

    数据库 2023年6月14日
    084
  • linux系统安装MySQL数据库安装保姆级教程及1045错误和2058问题解决

    使用Mysql的zip压缩包解压版,下载之后需进行一定的配置,才能使用它。下面对Mysql压缩包版的安装方法进行详细的描述,如有疑问或错误,望及时反馈。 首先,mysql的官方下载…

    数据库 2023年6月11日
    078
  • LeetCode 344. 反转字符串

    编写一个函数,其作用是将输入的字符串反转过来。输入字符串以字符数组 s 的形式给出。 //输入一个字符串,输出它的倒序字符串 input: Hello output: olleH …

    数据库 2023年6月11日
    080
  • NO.5 MySQL-笔记

    404. 抱歉,您访问的资源不存在。 可能是URL不正确,或者对应的内容已经被删除,或者处于隐私状态。 [En] It may be that the URL is incorre…

    数据库 2023年5月24日
    077
亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球