【VS code】使用VS Code配置配置Markdown环境
1. 安装VS Code
官网网站: https://code.visualstudio.com/
Markdown语法: https://markdown.com.cn/
2. 安装Markdown扩展 (根据自己需求安装)
1. Markdown All in One
2. Markdown Preview Enhanced
3. Markdown PDF
4. markdownlint
5. Markdown Preview Github Styling
6. Auto-Open Markdown Preview
3. 编写简单Markdown
>微信公众号排版工具。问题或建议,请公众号留言。**[程序员翻身](#jump_8)** 建议使用 **Chrome** 浏览器,体验最佳效果。 使用微信公众号编辑器有一个十分头疼的问题:粘贴出来的代码,格式错乱,空间小还带行号,而且特别丑。Markdown.com.cn编辑器能够解决这个问题。 Markdown是一种轻量级的「标记语言」。 请阅读下方文本熟悉工具使用方法,本文可直接拷贝到微信中预览。 ## 1 Markdown.com.cn 简介 - 支持自定义样式的 Markdown 编辑器 - 支持微信公众号、知乎和稀土掘金 - 点击右上方对应图标,一键复制到各平台 ## 2 Markdown语法教程 ### 2.1 标题 不同数量的`#`可以完成不同的标题,如下: # 一级标题 ## 二级标题 ### 三级标题 ### 2.2 字体 粗体、斜体、粗体和斜体,删除线,需要在文字前后加不同的标记符号。如下: **这个是粗体** *这个是斜体* ***这个是粗体加斜体*** ~这里想用删除线~~ 注:如果想给字体换颜色、字体或者居中显示,需要使用内嵌HTML来实现。 ### 2.3 无序列表 无序列表的使用,在符号`-`后加空格使用。如下: - 无序列表 1 - 无序列表 2 - 无序列表 3 如果要控制列表的层级,则需要在符号`-`前使用空格。如下: - 无序列表 1 - 无序列表 2 - 无序列表 2.1 - 无序列表 2.2 **由于微信原因,最多支持到二级列表**。 ### 2.4 有序列表 有序列表的使用,在数字及符号`.`后加空格后输入内容,如下: 1. 有序列表 1 2. 有序列表 2 3. 有序列表 3 ### 2.5 引用 引用的格式是在符号`>`后面书写文字。如下: > 读一本好书,就是在和高尚的人谈话。 ——歌德 > 雇用制度对工人不利,但工人根本无力摆脱这个制度。 ——阮一峰 ### 2.7 链接 微信公众号仅支持公众号文章链接,即域名为`https://mp.weixin.qq.com/`的合法链接。使用方法如下所示: 对于该论述,欢迎读者查阅之前发过的文章,[你是《未来世界的幸存者》么?](https://mp.weixin.qq.com/s/s5IhxV2ooX3JN_X416nidA) <a id="jump_8"></a> ### 2.8 图片 插入图片,格式如下: ![这里写图片描述](https://www.nginx.cn/wp-content/uploads/2020/03/qrcode_for_gh_82cf87d482f0_258.jpg) 支持 jpg、png、gif、svg 等图片格式,**其中 svg 文件仅可在微信公众平台中使用**,svg 文件示例如下: ![](https://my-wechat.mdnice.com/mdnice/i_am_svg_20191024083453.svg) 支持图片**拖拽和截图粘贴**到编辑器中。 注:支持图片 ***拖拽和截图粘贴*** 到编辑器中,仅支持 https 的图片,图片粘贴到微信时会自动上传微信服务器。 ### 2.9 分割线 可以在一行中用三个以上的减号来建立一个分隔线,同时需要在分隔线的上面空一行。如下: --- ### 2.10 表格 可以使用冒号来定义表格的对齐方式,如下: | 姓名 | 年龄 | 工作 | | :----- | :--: | -------: | | 小可爱 | 18 | 吃可爱多 | | 小小勇敢 | 20 | 爬棵勇敢树 | | 小小小机智 | 22 | 看一本机智书 | ## 3. 特殊语法 ### 3.1 脚注 > 支持平台:微信公众号、知乎。 脚注与链接的区别如下所示: ```markdown 链接:[文字](链接) 脚注:[文字](脚注解释 "脚注名字") ``` 有人认为在[大前端时代](https://en.wikipedia.org/wiki/Front-end_web_development "Front-end web development")的背景下,移动端开发(Android、IOS)将逐步退出历史舞台。 [全栈工程师](是指掌握多种技能,并能利用多种技能独立完成产品的人。 "什么是全栈工程师")在业务开发流程中起到了至关重要的作用。 脚注内容请拉到最下面观看。 ### 3.2 代码块 > 支持平台:微信代码主题仅支持微信公众号!其他主题无限制。 如果在一个行内需要引用代码,只要用反引号引起来就好,如下: Use the `printf()` function. 在需要高亮的代码块的前一行及后一行使用三个反引号,同时**第一行反引号后面表示代码块所使用的语言**,如下: ```java // FileName: HelloWorld.java public class HelloWorld { // Java 入口程序,程序从此入口 public static void main(String[] args) { System.out.println("Hello,World!"); // 向控制台打印一条语句 } } ``` 支持以下语言种类: ``` bash clojure,cpp,cs,css dart,dockerfile, diff erlang go,gradle,groovy haskell java,javascript,json,julia kotlin lisp,lua makefile,markdown,matlab objectivec perl,php,python r,ruby,rust scala,shell,sql,swift tex,typescript verilog,vhdl xml yaml ``` 如果想要更换代码高亮样式,可在上方**代码主题**中挑选。 其中**微信代码主题与微信官方一致**,有以下注意事项: - 带行号且不换行,代码大小与官方一致 - 需要在代码块处标志语言,否则无法高亮 - 粘贴到公众号后,用鼠标点代码块内外一次,完成高亮 diff 不能同时和其他语言的高亮同时显示,且需要调整代码主题为微信代码主题以外的代码主题才能看到 diff 效果,使用效果如下: ```diff + 新增项 - 删除项 ``` **其他主题不带行号,可自定义是否换行,代码大小与当前编辑器一致** ### 3.3 数学公式 > 支持平台:微信公众号、知乎。 行内公式使用方法,比如这个化学公式:$\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}$ 块公式使用方法如下: $$H(D_2) = -\left(\frac{2}{4}\log_2 \frac{2}{4} + \frac{2}{4}\log_2 \frac{2}{4}\right) = 1$$ 矩阵: $$ \begin{pmatrix} 1 & a_1 & a_1^2 & \cdots & a_1^n \\ 1 & a_2 & a_2^2 & \cdots & a_2^n \\ \vdots & \vdots & \vdots & \ddots & \vdots \\ 1 & a_m & a_m^2 & \cdots & a_m^n \\ \end{pmatrix} $$ 公式由于微信不支持,目前的解决方案是转成 svg 放到微信中,无需调整,矢量不失真。 目前测试如果公式量过大,在 Chrome 下会存在粘贴后无响应,但是在 Firefox 中始终能够成功。 ### 3.4 TOC > 支持平台:微信公众号、知乎。 TOC 全称为 Table of Content,列出全部标题。 [TOC] 由于微信只支持到二级列表,本工具仅支持二级标题和三级标题的显示。 ### 3.5 注音符号 > 支持平台:微信公众号。 支持注音符号,用法如下: Markdown Nice 这么好用,简直是{喜大普奔|hē hē hē hē}呀! ### 3.6 横屏滑动幻灯片 > 支持平台:微信公众号。 通过`<![](url),![](url)>`这种语法设置横屏滑动滑动片,具体用法如下: <![蓝1](https://my-wechat.mdnice.com/mdnice/%E8%93%9D1_20191109174052.jpg),![绿2](https://my-wechat.mdnice.com/mdnice/%E7%BB%BF2_20191109174052.jpg),![红3](https://my-wechat.mdnice.com/mdnice/%E7%BA%A23_20191109174052.jpg)> ## 4 其他语法 ### 4.1 HTML 支持原生 HTML 语法,请写内联样式,如下: <span style="display:block;text-align:right;color:orangered;">橙色居右</span> <span style="display:block;text-align:center;color:orangered;">橙色居中</span> ### 4.2 UML 不支持,推荐使用开源工具`https://draw.io/`制作后再导入图片 ## 5 致谢 * 编程如画 [markdown-nice-docs](https://github.com/mdnice/markdown-nice "插件原作者") * 歌词经理 [wechat-fromat](https://github.com/lyricat/wechat-format "灵感来源") * 颜家大少 [MD2All](http://md.aclickall.com/ "MdA2All")
4. 快捷键预览
先按: CTRL+K
再按 V
5. 生成PDF
右键, 直接转换为PDF
更多功能,自己探索