Apifox Markdown English
    Apifox Markdown English
    • Welcome to Apifox Markdown
    • Basic Syntax and Features
      • Title and Text
      • Lists & Tables
      • Image
      • Video
      • Code
      • Icon
      • Tailwind CSS Supports
    • Components
      • Admonition
      • Hightlight
      • Accordion
      • AccordionGroup
      • Multiple Columns
      • Card
      • Card Group
      • Image Frame
      • Image Background
      • Step
      • Tab
      • Tip
      • Copy to Clipboard
      • Text Hover Tip
      • Container
      • Text Drawing - Mermaid
        • Graph
        • Sequence Diagram
        • Class Digram
        • State Diagram
        • Entity Relationship Diagram
        • Journey Map
        • Gantt Chart
        • Pie Chart
      • Formula
        • Inline Formula
        • Block-level Formula
    • Other Questions
      • Shortcuts

    Welcome to Apifox Markdown

    The Disadvantage of Native Markdown Syntax#

    Native Markdown syntax is the preferred format for writing technical content among developers. However, its support for more specialized endpoint documentation is somewhat lacking. Many users have to rely on simple table syntax to fill in various input parameters for endpoints and use code blocks to present request/response results.
    We believe there is significant space for improvement.

    What is Apifox Markdown?#

    Based on Apifox's excellent support for endpoints documentation, more and more developers are choosing Apifox as their team's technical documentation writing platform.
    Continuously providing developers with a smooth writing and visual experience has always been Apifox's goal. After much consideration and refinement of API documentation, we are pleased to launch Apifox Markdown Syntax.
    Building on the native Markdown syntax, Apifox Markdown Syntax adds a wide range of easy-to-use component libraries. All built-in elements come with well-organized and designed styles.
    Apifox Advanced Styles
    It allows you to focus more on content creation itself, without worrying about how to design aesthetically pleasing layouts. Simply input a few simple syntaxes, and you can create visually appealing technical content effortlessly.

    Feature Highlights#

    1.
    Easy to Get Started: Apifox Markdown Syntax is simple, easy to learn and use. Combined with an online editor that supports visual insertion of advanced functional components, makes it user-friendly.
    2.
    High Readability: The component library within Apifox Markdown Syntax is written in plain code text, eliminating the need for complex CSS layout and style syntax, making the documentation more readable.
    3.
    Rich Formatting: Markdown documents written in Apifox can be easily converted to other formats such as HTML and PDF, making it convenient to view on different devices and platforms.
    4.
    Aesthetic Styles: The built-in syntax components like buttons, sequence diagrams, and highlight blocks for tips are all meticulously designed for a beautiful and cohesive look.
    5.
    Wide Compatibility: In Apifox, users can directly export API documentation in Markdown format, import and edit Markdown files from other platforms, seamlessly integrating the documentation with the API development process.
    6.
    Hight Customizability: After editing the Markdown content, authors can easily publish the content on the internet and share it with others. They can also customize document domains and brand logos, and adjust theme colors for personalization.
    TIP
    Apifox Markdown Syntax is designed to be used with Apifox's built-in online API document editor.

    Quick Start#

    1
    Register and Log In
    Register/Log in to Apifox
    2
    Import/Create Markdown File
    Import a Markdown file into a project within Apifox, or create a new project → Add a Markdown file in the root directory.
    3
    Start Writing
    After entering the project, click on the Markdown file in the left-hand directory. You will then see a visual editing box, with code content on the left and a text preview on the right. The top bar contains convenient visual content components; you can either use code to directly call styles or manually click to insert components.
    4
    Share and Collaborate
    For completed documents, the author can also click the "Share Docs" button on the left to generate a link and publish it on the internet, making it easy to share with other team members or clients for review and facilitating efficient collaboration.
    Next
    Title and Text
    Built with