玉溪市建设厅官方网站,app设计方案模板,婚纱摄影网站模板下载,网站地址做图标背景
markdown是一种便于编写和版本控制的格式#xff0c;但却不便于预览——特别是包含表格等复杂内容时#xff0c;单纯的语法高亮是远远不够的——这样就不能边预览边调整内容#xff0c;需要找到一种预览方法。
思路
linux下有个工具#xff0c;叫pandoc#xff0c…背景
markdown是一种便于编写和版本控制的格式但却不便于预览——特别是包含表格等复杂内容时单纯的语法高亮是远远不够的——这样就不能边预览边调整内容需要找到一种预览方法。
思路
linux下有个工具叫pandoc支持多种文档之间的转换我们可以用它将mdmarkdown文件转换成html再用浏览器打开html文件来预览内容调整完毕后再用pandoc将md文件转换成pdf最后发布出去。
实现方法
以这个md文件为例我们要实现该文件的预览
# 通信协议的帧格式## 读寄存器### 主机发包格式| preamble | read_reg | reg_address |
| -------- | --------- | ----------- |
| 0x1b | 0x01 | 0x08 |### 主机收包格式| reg_value |
| -------- |
| 0x00010000 |
markdown转html
实现效果
使用以下脚本实现
#!/bin/sh
OF/tmp/t.html
pandoc --metadata pagetitleAPI Document -f markdown -t html -c ~/bin/md.css -o $OF -s $1
firefox $OF几点说明
首先要安装pandocfirefox如果没预装就装一个用于预览html文件内容需要提供一个渲染页面格式的css文件不然表格都没边框很难看。脚本里的md.css是我网上找的资源附件里应该有
markdown转pdf
实现效果 使用以下脚本实现
#!/bin/sh
OF/tmp/t.pdf
pandoc --pdf-enginexelatex -V CJKmainfontNoto Sans CJK SC -V geometrytop2cm, bottom1.5cm, left2cm, right2cm -f markdown -t latex -o $OF -s $1
evince $OF几点说明
首先要确保pandoc已安装安装texlive、texlive-xetex、texlive-lang-chinese、fonts-noto-cjk等包确保pdf的中文能识别中文字体能显示。 2.1 如果pandoc或xelatex报错一般是前面的包还不完整根据提示补充安装即可。如果系统没安装evince的话安装上用于预览pdf文件。
总结
虽然现在有很多markdown在线预览工具但是如果你对保密有要求或者不能访问互联网那pandoc还是很有用的。 另外pandoc有很多命令示例大家使用时可以参考。
