Skip to main content

attributes in markdown

Project description

anchor_txt: attributes in markdown

anchor_txt adds the ability to embed attributes in markdown files so that external tools can more easily link them to eachother and code, as well as perform other operations.

Use anchor_txt.Section.from_md_path to load a markdown file.

# Markdown Syntax The syntax for anchor_txt attributes is simple.

  • Headers of the form # header {#anchor} will have the anchor tag extracted and available in Header.anchor

  • A header creates a Section, which can have sub sections.

  • Sections have attributes, which are embedded yaml either inline or in fenced code blocks, shown below.

An inline attribute looks like one of these: ` `@{foo}` `@{bar: 2}` `

Fenced code block attributes look like below. They must include the identifier yaml (or json) and end with a @

`yaml @ foo: null bar: 2 `

Attributes blocks within a Section are combined through the same process as dict.update, except overlapping keys throw an error.

# Developer Run make init to create the necessary virtualenv

Run make test for basic tests or make check for lints and formatting.

# License

The source code is Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anchor_txt-0.1.6.tar.gz (8.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page