With this Confluence Server/DC add-on, your users will see a new macro to render markdown in Confluence pages
Follow the classic way to install using the Find new apps, and look for "Marked"
And put a link to your mardown file
Result:
👇
When working with repositories which require authentication you'll need to use the associated API in order to access those files. For example you'll not be able to access a file on a private GitLab instance using the following URL:
https://gitlab.yourdomain.com/your-group/your-project/blob/master/README.md
Instead you will have to authenticate via the GitLab API. You might want to add a guest user to your GitLab project and use his/her private token.
In order to get the correct URL you would do the following:
https://gitlab.yourdomain.com/api/v3/projects/your-group%2Fyour-project?private_token=your-private-token
https://gitlab.yourdomain.com/api/v3/projects/your-project-id/repository/tree?private_token=your-private-token
https://gitlab.yourdomain.com/api/v3/projects/your-project-id/repository/raw_blobs/your-file-id?private_token=your-private-token
For private Bitbucket repositories, token authentication is supported:
https://x-token-auth:TOKEN@bitbucket.example.com:PORT/rest/api/1.0/projects/PROJECT/repos/REPO/raw/README.md
Note: When working with another repository management system you will have to comply with the API given.
marked also supports basic auth (http[s]://user:password@...
) and bearer (token) auth (http[s]://x-token-auth:token@...
).
Instead of the expected output you might see the following error message:
Cannot read resource. sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
The cause of the exception is that the resource host is running over SSL and your Confluence instance doesn't trust the certificate of that host.
The solution is to add the resource host's SSL Certificate to the Confluence Java Keystore. For more information please refer to the Confluence documentation.
Release Notes |
23-11-2023 Marked is now part of TecnoFor Apps