Markdown & LaTex 写作指南
2024-09-28 16:04:56 #教程

Markdown 简介

Markdown 是一种轻量级标记语言，设计用于以简洁易读的方式编写格式化文本，并且可以很容易转换为 HTML、PDF 等格式。它被广泛应用于文档编写、博客、电子邮件等文本内容的格式化。

Markdown 基本语法：

  • 标题：使用 # 符号来表示标题，# 的个数决定标题级别。

    1
    2
    3
    # 一级标题
    ## 二级标题
    ### 三级标题

  • 加粗：使用 ** 或 __ 包裹文字。

    1
    **加粗文字** 或 __加粗文字__

  • 斜体：使用 * 或 _ 包裹文字。

    1
    *斜体文字* 或 _斜体文字_

  • 列表：

    • 无序列表使用 *、- 或 +。
      1
      2
      * 项目1
      * 项目2
    • 有序列表使用数字加点。
      1
      2
      1. 第一项
      2. 第二项

  • 链接：使用 [链接文本](链接地址)。

    1
    [Google](https://www.google.com)

  • 图片：使用 ![图片描述](图片地址)。

    1
    ![GitHub Logo](https://github.com/logo.png)

  • 代码块：

    • 行内代码使用 `代码`。
    • 多行代码使用三个反引号（```）包裹代码。

Markdown 优点：

  • 简洁易用，语法清晰。
  • 兼容性好，支持多种平台与工具。
  • 转换方便，可导出为 HTML、PDF 等多种格式。

LaTeX 简介

LaTeX 是一种基于 TeX 的排版系统，特别适合撰写复杂的科学技术文档，如数学公式、论文、书籍等。相比 Markdown，LaTeX 功能强大，可以进行更复杂的排版控制。

LaTeX 基本语法：

  • 文档结构：
    LaTeX 文档通常使用如下的结构：

    1
    2
    3
    4
    \documentclass{article}  % 文档类型
    \begin{document}         % 开始正文
    Hello, world!            % 文本内容
    \end{document}           % 结束正文

  • 段落：段落之间用空行分隔。

  • 标题：使用 \section、\subsection 来创建标题。

    1
    2
    \section{一级标题}
    \subsection{二级标题}

  • 加粗：使用 \textbf{}。

    1
    \textbf{加粗文字}

  • 斜体：使用 \textit{}。

    1
    \textit{斜体文字}

  • 列表：

    • 无序列表使用 itemize 环境。
      1
      2
      3
      4
      \begin{itemize}
        \item 项目1
        \item 项目2
      \end{itemize}
    • 有序列表使用 enumerate 环境。
      1
      2
      3
      4
      \begin{enumerate}
        \item 第一项
        \item 第二项
      \end{enumerate}

  • 数学公式：
    LaTeX 最为著名的功能之一是它对数学公式的支持。

    • 行内公式使用 $ 包裹。
      1
      $E = mc^2$
    • 块状公式使用 \[ \]。
      1
      2
      3
      \[
      E = mc^2
      \]

  • 图片：使用 graphicx 包插入图片。

    1
    2
    3
    4
    5
    6
    \usepackage{graphicx}
    \begin{figure}
      \centering
      \includegraphics[width=0.5\textwidth]{image.png}
      \caption{图片描述}
    \end{figure}

LaTeX 配置：

  • MikTex 排版系统：点击前往,检查安装：xelatex
  • 清华大学开源镜像站 CTAN：点击前往
  • Visual Studio Code 编辑器：点击前往
  • 插件：LaTeX Workshop，在当前.tex文件编辑环境下，按F1，打开首选项：打开工作区设置（JSON），插件配置代码如下（不包含外部 pdf 查看器设置）：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    {
        "latex-workshop.latex.autoBuild.run": "never",
        "latex-workshop.showContextMenu": true,
        "latex-workshop.intellisense.package.enabled": true,
        "latex-workshop.message.error.show": false,
        "latex-workshop.message.warning.show": false,
        "latex-workshop.latex.tools": [
            {
                "name": "xelatex",
                "command": "xelatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOCFILE%"
                ]
            },
            {
                "name": "pdflatex",
                "command": "pdflatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOCFILE%"
                ]
            },
            {
                "name": "latexmk",
                "command": "latexmk",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "-pdf",
                    "-outdir=%OUTDIR%",
                    "%DOCFILE%"
                ]
            },
            {
                "name": "bibtex",
                "command": "bibtex",
                "args": [
                    "%DOCFILE%"
                ]
            }
        ],
        "latex-workshop.latex.recipes": [
            {
                "name": "XeLaTeX",
                "tools": [
                    "xelatex"
                ]
            },
            {
                "name": "PDFLaTeX",
                "tools": [
                    "pdflatex"
                ]
            },
            {
                "name": "BibTeX",
                "tools": [
                    "bibtex"
                ]
            },
            {
                "name": "LaTeXmk",
                "tools": [
                    "latexmk"
                ]
            },
            {
                "name": "xelatex -> bibtex -> xelatex*2",
                "tools": [
                    "xelatex",
                    "bibtex",
                    "xelatex",
                    "xelatex"
                ]
            },
            {
                "name": "pdflatex -> bibtex -> pdflatex*2",
                "tools": [
                    "pdflatex",
                    "bibtex",
                    "pdflatex",
                    "pdflatex"
                ]
            },
        ],
        "latex-workshop.latex.clean.fileTypes": [
            "*.aux",
            "*.bbl",
            "*.blg",
            "*.idx",
            "*.ind",
            "*.lof",
            "*.lot",
            "*.out",
            "*.toc",
            "*.acn",
            "*.acr",
            "*.alg",
            "*.glg",
            "*.glo",
            "*.gls",
            "*.ist",
            "*.fls",
            "*.log",
            "*.fdb_latexmk"
        ],
        "latex-workshop.latex.autoClean.run": "onFailed",
        "latex-workshop.latex.recipe.default": "lastUsed",
        "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click"
    }
  • (可选)使用SumatraPDF查看的代码配置，代码展示 :
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    {
        "latex-workshop.view.pdf.viewer": "external",
        "latex-workshop.view.pdf.ref.viewer":"auto",
        "latex-workshop.view.pdf.external.viewer.command": "F:/SumatraPDF/SumatraPDF.exe", // 注意修改路径
        "latex-workshop.view.pdf.external.viewer.args": [
            "%PDF%"
        ],
        "latex-workshop.view.pdf.external.synctex.command": "F:/SumatraPDF/SumatraPDF.exe", // 注意修改路径
        "latex-workshop.view.pdf.external.synctex.args": [
            "-forward-search",
            "%TEX%",
            "%LINE%",
            "-reuse-instance",
            "-inverse-search",
            "\"F:/Microsoft VS Code/Code.exe\" \"F:/Microsoft VS Code/resources/app/out/cli.js\" -r -g \"%f:%l\"", // 注意修改路径
            "%PDF%"
        ]
    }
  • 插件 Zotero LaTex ,与Zotero客户端Better BibTeX 插件则可以帮助用户更好地管理 BibTeX 数据库和处理 LaTeX 引用。首先建立.bib文件，插件使用命令改为cite，Zotero LaTeX导入参考文献，快捷键Alt+Z打开。
    1
    2
    \bibliographystyle{plain}    //定义参考文献格式
    \bibliography{ref}           //ref.bib文件路径
  • 上海交通大学 LaTeX 论文模板点击前往
  • LaTeX-Essay.EN 模板点击前往
    PS：故障报错解决
  1. 如出现MiKTeX could not find the script engine 'perl.exe' which is required to execute 'latexmk'.，解决方案：下载草莓版安装包，不要下载ActivePerl版本。原因：MikTex可以认为是Tex本体，如果要在VSCode里面写LaTex的话，一种可行的方式是借助VSCode插件（LaTex Workshop），此即为文中所述。而要正常使用该插件则要求本地有perl支持。
  2. 不能正常编译，配置环境变量。方法：我的电脑>属性>高级系统设置>环境变量>path，新建文件安装路径yourpath/miktex/bin添加到环境变量保存即可。

LaTeX 优点：

  • 功能强大，特别适合复杂的排版需求。
  • 对数学公式、引用、目录等有极其优秀的支持。
  • 广泛应用于学术界，尤其是科学和工程领域。

总结

  • Markdown：简单、轻量，适合编写博客、简单文档、README 文件等，易学易用。
  • LaTeX：功能强大，适合处理复杂的文档，特别是在学术、技术和数学领域。
Prev
2024-09-28 16:04:56 #教程
Next