最近由於項目需要,要用到把markdown轉換成pdf文件下載下來,最開始的時候想到的是先把markdown轉成html,用到的是Parsedown;然后再將html轉成pdf,用到了html2pdf,這是兩個php的類庫,安裝起來十分簡單,只需要用composer安裝即可。
"require": {
"spipu/html2pdf": "^4.6",
"erusev/parsedown": "^1.6"
},
將這兩句加入到composer.json中,運行composer install。這樣在vendor中會多處三個文件夾:erusev,spipu,tecnickcom。
下面是php的部分代碼:
$result = Parsedown::instance()->parse($comtent);//$content是從數據庫取出的markdown的東西 $html2pdf = new HTML2PDF('P', 'A4', 'fr', true, 'UTF-8', 3); $html2pdf->SetDefaultFont('droidsansfallback');//設置字體,這個字體需要自己去添加,因為html2pdf本身是不支持中文的,會出現亂碼,你需要把droidsansfallback.php、droidsansfallback.z以及droidsansfallback.ctg.z(可以百度到的)這三個文件復制到 TCPDF\fonts 下面即可。
//html2pdf中文支持底層是TCPDF實現的,在執行composer install的時候會自動安裝上tcpdf. $html2pdf->writeHTML($result); $html2pdf->Output('a.pdf');輸出a.pdf文件,直接下載了。
這樣試一試真的可以下載pdf文件了。。。但是,你會發現中文都沒有換行。這是一個大坑,我在網上找了好多資料都沒有好的解決辦法;
暫時不提這個,接着我們還有個需求就是需要批量下載,這是我遇到的第二個坑,html2pdf沒有生成pdf文件,而是直接通過header()函數發送到瀏覽器(這個你可以查看$html2pdf->Output()這個函數源碼),所以批量下載也會有很多麻煩。
其次當你的md中有代碼的時候,也就是轉化的html有這樣的標簽,<pre><code>測試</code></pre>,中文就會出現亂碼,這個即便你已經設置了中文字體也會出現。
經歷了這些,我果斷放棄了這種方法。但是,總會有其他的辦法的,於是我找到了pandoc。
我簡單介紹一下這個東西,它被稱作是一款神器
它可以把markdown、 reStructuredText、 textile、 HTML、或者LaTeX轉換成:
HTML格式: XHTML, HTML5, 以及HTML幻燈片Slidy, S5,或者DZSlides.
文字處理軟件格式: Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML
電子書: EPUB
文檔格式: DocBook, GNU TexInfo, Groff man pages
TeX格式: LaTeX, ConTeXt, LaTeX Beamer slides
PDF via LaTeX
輕量級標記語言格式: Markdown, reStructuredText, AsciiDoc, MediaWiki markup, Emacs Org-Mode, Textile。
我的是mac環境,所以安裝pandoc:
brew install pandoc
pandoc 在生成pdf時需要借助laTex排版引擎,不建議安裝精簡版的,因為這樣還需要安裝各種依賴包;我直接安裝了mactex(挺大的大概兩個多GB),這時候我們就可以借助命令行生成生成pdf了,是不是有點小激動呢~
pandoc --latex-engine=xelatex -V mainfont='STSong' --template=pandoc/pm-template a.md -o a.pdf //STSong是mac中的一種中文字體,這個字體一定要保證你的電腦上有才行
$stream = fopen(a.md, "w+");//生成a.md文件 fwrite($stream,$content);//將md內容寫到該文件中 exec('pandoc --latex-engine=xelatex -V mainfont=\'STSong\' --template=my a.md -o a.pdf',$output,$return_val);//執行轉化命令,--latex-engine=xelatex 指定排版引擎為 xelatex ,為什么?因為默認的排版引擎不支持中文.
以下是我提供的my.latex模版
\documentclass[$if(fontsize)$$fontsize$,$endif$$if(lang)$$lang$,$endif$$if(papersize)$$papersize$,$endif$]{$documentclass$} \usepackage{geometry} % 設定邊界 \geometry{ top=1in, inner=1in, outer=1in, bottom=1in, headheight=3ex, headsep=2ex } \usepackage[T1]{fontenc} \usepackage{lmodern} \usepackage{amssymb,amsmath} \usepackage{ifxetex,ifluatex} \usepackage{fixltx2e} % provides \textsubscript % use upquote if available, for straight quotes in verbatim environments \IfFileExists{upquote.sty}{\usepackage{upquote}}{} \ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex \usepackage[utf8]{inputenc} $if(euro)$ \usepackage{eurosym} $endif$ \else % if luatex or xelatex \usepackage{fontspec} % 允許設定字體 \usepackage{xeCJK} % 分開設置中英文字型 \setCJKmainfont{STSong} % 設定中文字型 \setmainfont{Georgia} % 設定英文字型 \setromanfont{Georgia} % 字型 \setmonofont{Courier New} \linespread{1.2}\selectfont % 行距 \XeTeXlinebreaklocale "zh" % 針對中文自動換行 \XeTeXlinebreakskip = 0pt plus 1pt % 字與字之間加入0pt至1pt的間距,確保左右對整齊 \parindent 0em % 段落縮進 \setlength{\parskip}{20pt} % 段落之間的距離 \ifxetex \usepackage{xltxtra,xunicode} \fi \defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase} \newcommand{\euro}{€} $if(mainfont)$ \setmainfont{$mainfont$} $endif$ $if(sansfont)$ \setsansfont{$sansfont$} $endif$ $if(monofont)$ \setmonofont{$monofont$} $endif$ $if(mathfont)$ \setmathfont{$mathfont$} $endif$ \fi % use microtype if available \IfFileExists{microtype.sty}{\usepackage{microtype}}{} $if(geometry)$ \usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry} $endif$ $if(natbib)$ \usepackage{natbib} \bibliographystyle{plainnat} $endif$ $if(biblatex)$ \usepackage{biblatex} $if(biblio-files)$ \bibliography{$biblio-files$} $endif$ $endif$ $if(listings)$ \usepackage{listings}ƒ $endif$ $if(lhs)$ \lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{} $endif$ $if(highlighting-macros)$ $highlighting-macros$ $endif$ $if(verbatim-in-note)$ \usepackage{fancyvrb} $endif$ $if(tables)$ \usepackage{longtable} $endif$ $if(graphics)$ \usepackage{graphicx} % We will generate all images so they have a width \maxwidth. This means % that they will get their normal width if they fit onto the page, but % are scaled down if they would overflow the margins. \makeatletter \def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth \else\Gin@nat@width\fi} \makeatother \let\Oldincludegraphics\includegraphics \renewcommand{\includegraphics}[1]{\Oldincludegraphics[width=\maxwidth]{#1}} $endif$ \ifxetex \usepackage[setpagesize=false, % page size defined by xetex unicode=false, % unicode breaks when used with xetex xetex]{hyperref} \else \usepackage[unicode=true]{hyperref} \fi \hypersetup{breaklinks=true, bookmarks=true, pdfauthor={$author-meta$}, pdftitle={$title-meta$}, colorlinks=true, urlcolor=$if(urlcolor)$$urlcolor$$else$blue$endif$, linkcolor=$if(linkcolor)$$linkcolor$$else$magenta$endif$, pdfborder={0 0 0}} \urlstyle{same} % don't use monospace font for urls $if(links-as-notes)$ % Make links footnotes instead of hotlinks: \renewcommand{\href}[2]{#2\footnote{\url{#1}}} $endif$ $if(strikeout)$ \usepackage[normalem]{ulem} % avoid problems with \sout in headers with hyperref: \pdfstringdefDisableCommands{\renewcommand{\sout}{}} $endif$ \setlength{\parindent}{0pt} %\setlength{\parskip}{6pt plus 2pt minus 1pt} \setlength{\emergencystretch}{3em} % prevent overfull lines \title{\huge 在OSX平台上的XeLaTeX中文測試} % 設置標題,使用巨大字體 \author{FoolEgg.com} % 設置作者 \date{February 2013} % 設置日期 \usepackage{titling} \setlength{\droptitle}{-8em} % 將標題移動至頁面的上面 \usepackage{fancyhdr} \usepackage{lastpage} \pagestyle{fancyplain} $if(numbersections)$ \setcounter{secnumdepth}{5} $else$ \setcounter{secnumdepth}{0} $endif$ $if(verbatim-in-note)$ \VerbatimFootnotes % allows verbatim text in footnotes $endif$ $if(lang)$ \ifxetex \usepackage{polyglossia} \setmainlanguage{$mainlang$} \else \usepackage[$lang$]{babel} \fi $endif$ $for(header-includes)$ $header-includes$ $endfor$ $if(title)$ \title{$title$} $endif$ \author{$for(author)$$author$$sep$ \and $endfor$} \date{$date$} \begin{document} $if(title)$ \maketitle $endif$ $for(include-before)$ $include-before$ $endfor$ $if(toc)$ { \hypersetup{linkcolor=black} \setcounter{tocdepth}{$toc-depth$} \tableofcontents } $endif$ $body$ $if(natbib)$ $if(biblio-files)$ $if(biblio-title)$ $if(book-class)$ \renewcommand\bibname{$biblio-title$} $else$ \renewcommand\refname{$biblio-title$} $endif$ $endif$ \bibliography{$biblio-files$} $endif$ $endif$ $if(biblatex)$ \printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$ $endif$ $for(include-after)$ $include-after$ $endfor$ \end{document}