# How to Edit this Wiki

**[Wiki Home](https://hackmd.io/@fablabedp/home)**

This wiki is also available on [GitHub](https://raw.githubusercontent.com/fablabedp/fablabedp-wiki).

To maintain synchronisation between HackMD and GitHub, it is necessary to pull and push changes between them (see [Editing an Existing Page](#editing-an-existing-page)).

## Writing in Markdown

There are many good guides to writing in markdown, but here is a nice succinct one [github/cuonggt/markdown_guide.md](https://gist.github.com/cuonggt/9b7d08a597b167299f0d)

Here is a more complete overview from the original creator of markdown: https://daringfireball.net/projects/markdown/

There is a comprehensive guide to markdown and HackMD here: https://hackmd.io/c/tutorials/

## Making a New Page

1. Create a new markdown file for the page in the appropriate folder, and add some content. To facilitate navigation, add a link to the wiki home at the top of the page, after the page title:

` **[Wiki Home](https://hackmd.io/@fablabedp/home)**`

2. Make a commit for the new page to the repository on GitHub.
3. On the HackMD dashboard, select `New Note`
4. In the empty Note page, select `Pull from Github`, then select the `fablabedp-wiki` repo, `main` branch, and then navigate to the page and select `Pull`


5. In the pull dialog, select `Apply all changes`
6. Edit the page title and add any necessary tags. The first tag selected will be used as a category organiser on the HackMD dashboard.



7. When the page is ready to publish, Select `Share` and set note permisssions to read: `Everyone` and write: `Only me`. If necessary you can customise the page URL, then agree to the HackMD community guidelines and select `Publish`.


8. Edit the wiki home page to add a link to the new page. In order to make the links functional on GitHub, use HackMD absolute urls (eg: https://hackmd.io/50M-O-CoRtC3L6Bp-058dw)

## Editing an Existing Page

### Syncing from GitHub to HackMD

After pushing a commit to GitHub, any pages edited need to be manually updated on HackMD. In the page options select `Versions and GitHub Sync`.


If there are any new changes to synchronise there will be an orange dot on the Pull icon.


Select `Apply All Changes`, and then you can close the _Versions and GitHub Sync_ window.

### Syncing from HackMD to GitHub

After editing a page on HackMD, these can be pushed as a commit to GitHub. In the page options select `Versions and GitHub Sync`, the select `Push`, and with the main branch select click `Push`. If needed you can customise the commit name and description, but this is optional.

## Adding Images

Images can be added to the github repository for embedding in pages. In this case use the following link format as the image source:

``