---
title: "Tutorials"
canonical: "https://support.appfire.com/space/GMFC/705955580/Tutorials"
format: markdown
---
> Macro (aura-html)
> Macro (legacy-content)
## Overview of the macros
| **Macro name : **
**Description** | **How does it look?**
(The images shown here are mainly from the cloud version and are similar in the server version.) | **How would it appear on my page?** |
| --- | --- | --- |
| **Github Issue List Macro** :
Displays a list of issues from a specified repository. |  |  |
| **Github Pull Request List Macro **:
Displays a list of pull requests from a specified repository based on a query, if given. |  |  |
| **Github Markdown Macro** :
Displays the contents of a Markdown file located in a specific repository. |  |  |
| **Github File Macro** :
Displays the contents of a file located in a specific repository. |  |  |
## Parameters
This section lists the parameters available in the macros. Unless there are any differences between the server and cloud versions, the mentioned parameters are common to both.
### Common parameters
All parameters, except **Query**, are mandatory.
| **Parameter name** | **Description** |
| --- | --- |
| **Github Token** | Select the token to be used from the dropdown list. Contact your administrator if an error occurs or if you are unable to connect to the repository. For more information, see more in the *Configuration* page for [server](https://appfire.atlassian.net/wiki/x/CYD0C) and/or [cloud](https://appfire.atlassian.net/wiki/x/L4D0C). |
| **User** | Enter the user name required to access the relevant repository.
> 📝 In Github Markdown Macro (cloud), this parameter is available on the *Enter Repository Settings* tab labelled as *Username/Organization Username*. |
| **Repository** | Enter the repository name to be accessed. |
| **Query** | Enter a query to access the required pull requests or issues. Use the [Github's Query language](https://developer.github.com/v3/issues/#list-issues) to choose the pull requests or issues that you wish to display.
> 📝 - This parameter is available only in the Github Issues List Macro and Github Pull Request List Macro in both, server and cloud, versions.
> 📝 - The following attributes are supported:
> 📝 - `state=open` : fetches all PRs which are open
> 📝 - `state=closed` : fetches all PRs which are closed
> 📝 - `state=all` : fetches all PRs
> 📝 - `state=merged` : fetches all PRs which are closed and merged (available only in Github Pull Request List Macro)
> 📝 - `state=closed,unmerged` : fetches all PRs which are closed but not merged (available only in Github Pull Request List Macro) |
### Other parameters
The following parameters are available to specific macros:
| **Parameter name** | **Available in which macros?** | **Description** |
| --- | --- | --- |
| **URL** | Github Markdown Macro (cloud) | Enter the URL of the Markdown file to be accessed. Click the **Check** button to verify the file path. |
| **Branch or Commit Hash** | Github Markdown Macro (both versions; in cloud, under *Enter Repository Settings* tab)
Github File Mmacro (both versions) | Enter the branch or commit code to be accessed.
Examples: `master`, `develop`, `1.0.0` for a tag, or, `9b81f3072b6fc207c8b65d553a9c5422c757b5f5` for a specific commit. |
| **File Path** | Github Markdown Macro (both versions; in cloud, under *Enter Repository Settings* tab)
Github File Macro (both versions) | Enter the actual path of the Markdown file to be displayed. |
| **Hide line numbers of code block** (server)
**Hide line numbers** (cloud) | Github File Macro (both versions) | Enable this option to hide line numbers of the code block from being displayed. |
| **Lines of code** | Github File Macro (both versions) | Enter a line number or a range of lines to be displayed through the macro.
Example: `10` or `1-25`. |